List events | CONFIRM Docs

Returns the partner-wide event log, newest first — every event delivered (or deliverable) to your webhook endpoints across all organizations. Use it for recovery and backfill after an outage: filter by type, org_id, and since, then replay what you missed.

Authentication

AuthorizationBearer

Partner API key sent as Authorization: Bearer cfk_.... Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Query parameters

typeenumOptional

Filter by event type (e.g. screening.completed).

org_idstringOptional

Only events for this organization.

sincedatetimeOptional

Only events created at or after this time (ISO 8601).

limitintegerOptional1-100Defaults to 20

Page size, 1–100.

cursorstringOptional

Opaque cursor from a previous response’s next_cursor.

Response

Paginated event list.

datalist of objectsOptional

has_morebooleanOptional

next_cursorstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

1	{
2	"data": [
3	{
4	"id": "evt_9TqLp4XcRr",
5	"type": "candidate.created",
6	"created": "2024-01-15T09:30:00Z",
7	"org_id": "org_4Nv8sJqKfH",
8	"external_ref": "cl_app_84321",
9	"data": {
10	"object": {}
11	}
12	}
13	],
14	"has_more": true,
15	"next_cursor": "string"
16	}