Skip to navigation
API Referencesignals

List signals

Returns ingested signals (usage events) for your organization, newest first. Filter by signal name, customer, product, and creation date range.

Authentication

AuthorizationBearer
API Key authentication using Bearer token

Query parameters

limitintegerOptional1-100Defaults to 10
offsetintegerOptional
signalNamestringOptional>=1 character

Filter by signal event name (exact match).

customerIdstringOptional>=1 character
Filter by the Paid customer ID the signal is attributed to.
externalCustomerIdstringOptional>=1 character
Filter by your external customer ID. Aliases resolve to the attributed customer, and unresolved IDs match raw ingest data.
productIdstringOptional>=1 character
Filter by the Paid product ID the signal is attributed to.
externalProductIdstringOptional>=1 character
Filter by your external product ID.
createdAtFromstringOptional

Only signals created on or after this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

createdAtTostringOptional

Only signals created on or before this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

Response

200
datalist of objects
paginationobject

Errors

400
Bad Request Error
403
Forbidden Error
408
Request Timeout Error
429
Too Many Requests Error
500
Internal Server Error