List raw signals
Your organization's signals with their status (SUCCESS, PENDING or REJECTED), newest first, 50 a page, for the last 30 days unless you send from or to. Resend PENDING ones with Retry signals. An unknown customer gives an empty list, not a 404.
Base URL https://events.clocknext.com/api/v1
apiKeyAuthorizationBearer <cnk_…>Organisation-scoped key from Settings → API Keys.
customerId?stringOnly this customer's signals. If externalId is sent too, customerId wins. An unknown id is not an error: the list is empty.
externalId?stringOnly the signals of the customer with this externalId (1–64 letters, numbers or "-", matched exactly), and the signals sent with it that named no customer.
^[A-Za-z0-9-]{1,64}$1 <= length <= 64status?stringOnly signals with this status. One value.
"SUCCESS""PENDING""REJECTED"type?stringOnly signals of this type, in any case. OUTCOME gives a run's steps and its completion; COMPOSITE the composite completions.
"WALLET""CREDIT""UNIT""OUTCOME""COMPOSITE"from?stringFirst day to include, YYYY-MM-DD (UTC). The whole day is included. Omit it to start 30 days before the end of to, or 30 days before now.
dateto?stringLast day to include, YYYY-MM-DD (UTC). The whole day is included. Omit it for no end. Must not be before from.
datecursor?stringOpaque token from a previous response's nextCursor. Omit it for the first page. It keeps the first page's days, so the next pages read the same days however late you ask.
A page of signals, newest first.
application/json- response
statusCode*integerThe HTTP status code of the answer, for example 200 or 202.
statusDetail*The status of the request and a short message.
result*The data of the answer.
curl -X GET 'https://events.clocknext.com/api/v1/signal/list?customerId=cus_abc123&status=PENDING&type=CREDIT&from=2026-10-01&to=2026-10-07&cursor=eyJ0cyI6IjIwMjYtMTAtMDdUMTM6MDA6NTEuMDIzWiIsImlkIjoiMDE5MmExZWYtN2MxMS03YTIwLTliM2QtNGU1ZjZhN2I4YzlkIiwiZnJvbSI6IjIwMjYtMDktMDdUMDA6MDA6MDAuMDAwWiJ9'{ "statusCode": 200, "statusDetail": { "status": "SUCCESS", "message": "Signals loaded." }, "result": { "signals": [ { "id": "01a15a16-01d4-761e-baec-dbe7f088c96c", "createdAt": "2026-10-20T16:12:34.132Z", "status": "SUCCESS", "type": "UNIT", "payload": { "customerId": "cmvgva5po000c07iir1vtn8vl", "idempotencyKey": "chat:nw:req_2001", "agentKey": "pdf_export" } }, { "id": "01a15a15-ff39-734c-957c-d0387537a318", "createdAt": "2026-10-20T16:12:33.465Z", "status": "SUCCESS", "type": "CREDIT", "payload": { "customerId": "cmvgva5po000c07iir1vtn8vl", "member": "priya.raman@northwindtraders.com", "idempotencyKey": "chat:nw:req_2001", "usage": { "model": "gpt-4o-mini", "inputTokens": 2000, "outputTokens": 500, "cacheTokens": 0, "cacheWriteTokens": 0 }, "agentKey": "chat_message" } }, { "id": "01a15a15-d708-7784-a954-24cad1d90e00", "createdAt": "2026-10-20T16:12:23.176Z", "status": "SUCCESS", "type": "OUTCOME_COMPLETION", "payload": { "customerId": "cmvgva5po000c07iir1vtn8vl", "runId": "TCK-48299", "agentKey": "support_ticket" } }, { "id": "01a15a15-ccec-758e-ad47-1f18e965ad90", "createdAt": "2026-10-20T16:12:20.588Z", "status": "PENDING", "type": "CREDIT", "payload": { "externalId": "tailspin-org", "usage": { "model": "claude-sonnet-4-5", "inputTokens": 100, "outputTokens": 10, "cacheTokens": 0, "cacheWriteTokens": 0 }, "agentKey": "deep_research", "customerId": "cmvgv9ebb000707iipffdxzwj" }, "error": { "type": "user_error", "message": "Credit \"Deep Research\" is not part of this customer's plan, and no composite covering it is sold on this plan either." }, "attempts": 2 }, { "id": "01a15a15-c461-71f0-938e-3d34dbb1ed56", "createdAt": "2026-10-20T16:12:18.401Z", "status": "SUCCESS", "type": "WALLET", "payload": { "externalId": "fabrikam-org", "usage": { "model": "gemini-2.5-flash", "inputTokens": 40000, "outputTokens": 8000, "cacheTokens": 0, "cacheWriteTokens": 0 }, "customerId": "cmvgv9dyg000607ii9z6oghzf" } }, { "id": "01a15a15-bbc5-77a0-9dff-faa6f09479de", "createdAt": "2026-10-20T16:12:16.197Z", "status": "SUCCESS", "type": "OUTCOME", "payload": { "externalId": "contoso-org", "usage": { "model": "claude-haiku-4-5", "inputTokens": 2800, "outputTokens": 600, "cacheTokens": 0, "cacheWriteTokens": 0 }, "agentKey": "support_ticket.triage", "runId": "CT-9001", "customerId": "cmvgv9th0000a07iisl2s8u6q" } }, { "id": "01a15a15-b773-70e3-ad71-87994218bda2", "createdAt": "2026-10-20T16:12:15.091Z", "status": "SUCCESS", "type": "COMPOSITE", "payload": { "customerId": "cmvgva5po000c07iir1vtn8vl", "composite": { "research_report": "RPT-2026-Q4-EV" } } }, { "id": "01a15a15-d5ce-73e2-9ed0-cfd2fb08fd0c", "createdAt": "2026-10-20T16:12:22.862Z", "status": "SUCCESS", "type": "UNIT", "payload": { "customerId": "cmvgva5po000c07iir1vtn8vl", "agentKey": "pdf_export" } } ], "nextCursor": "eyJ0cyI6I…redacted" }}Types
Every object type on this page, with its fields.
SignalListEntry
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | The signal id. |
createdAt | string | yes | When the API received the signal. |
status | "SUCCESS" | "PENDING" | "REJECTED" | yes | SUCCESS: counted. PENDING: not counted yet, can be retried. REJECTED: given up, never counted. |
type | "WALLET" | "CREDIT" | "OUTCOME" | "OUTCOME_COMPLETION" | "UNIT" | "COMPOSITE" | null | yes | The route used. OUTCOME is a step, OUTCOME_COMPLETION a completion. null when unreadable. |
payload | object | null | yes | The request as stored: unknown keys dropped, defaults filled, customerId added. null when unreadable. |
error | object | no | Only on PENDING and REJECTED rows: why, and its type. |
attempts | integer | no | PENDING and REJECTED rows only: how many times the signal was processed. |
SignalListEntry.error
Only on PENDING and REJECTED rows: why, and its type.
| Field | Type | Required | Description |
|---|---|---|---|
type | "user_error" | "validation_error" | "server_error" | "not_yet" | null | yes | user_error (fix the request), not_yet (may pass later), server_error or validation_error. |
message | string | yes | What went wrong, in words. |
Complete composite POST
Completes one composite occurrence and bills it once. In `composite`, the key is its `refId` and the value is your occurrence id. Signals that carry this value are billed by the composite. Each call counts once, so send an `idempotencyKey`. Answers `202`; a signal that can't be counted stays `PENDING`.
Retry signals POST
Sends 1 to 50 `PENDING` signals through processing again, for example after you created the missing customer. Answers `202` at once; see the result in [List raw signals](/docs/api-reference/signals/eventsListSignals). A signal gets 11 attempts, then becomes `REJECTED`. A retry never counts a signal twice.