VocalDocscontracts 1.65.0

List the event log

GET /v1/events

PropertyValue
Operationlist_events
GroupEvents
Scopeevents:read
Route classread
IdempotencyNo Idempotency-Key
AuditNot audited: Vocal's types carry identifiers, status, codes and instants only (ADR 0051 rule 4); from 1.62.0 a custom event carries the customer's own data, which travels empty in PHI mode.
Released in1.52.0
Phase 0 hostServed (the hosted api pins 1.65.0)

Pages the Organization's record events of the last 30 days (a target), newest first by sequence, for the environment of the credential. types, families and filter_id select as a subscription does (types OR families, narrowed by the filter), and created_after and created_before bound the range. The payloads are built under the Organization's PHI mode at read time, as a delivery's are.

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the events:read scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl "$VOCAL_API/v1/events" \
  -H "Authorization: Bearer $VOCAL_API_KEY"

Parameters

NameInTypeRequiredDescription
limitqueryintegernoThe page size, 1 to 100.
cursorquerystringnoThe opaque next_cursor of the previous page; it binds the filters it was issued under.
typesqueryarray of EventTypeNamenoOnly these types, comma-separated; OR with families. Trace types reach the log and the stream only inside call.trace.ready, so naming one selects nothing.
familiesqueryarray of EventFamilynoOnly the types of these families, comma-separated.
filter_idqueryEventFilterIdnoNarrow the selection with this event filter; a filter that is not the Organization's answers not_found.
created_afterqueryRequestTimestampnoOnly the events created at or after this instant (1.52.0); the start of the range is inclusive.
created_beforequeryRequestTimestampnoOnly the events created before this instant (1.52.0); the end of the range is exclusive.

Responses

StatusContent typeShapeError codes
200application/jsonEventList
400application/jsonErrorEnvelopeinvalid_request, invalid_cursor
401application/jsonErrorEnvelopeunauthenticated
403application/jsonErrorEnvelopeforbidden
404application/jsonErrorEnvelopenot_found
429application/jsonErrorEnveloperate_limited
500application/jsonErrorEnvelopeinternal_error

Fields of the 200 answer

The shape is EventList.

FieldTypeRequiredDescription
dataarray of EventyesThe events of this page, newest first by sequence.
has_morebooleanyesTrue when a further page exists.
next_cursorstring or nullyesThe cursor of the next page, or null on the last page.
object"list"yes