List call logs (all, or for one agent)

GEThttps://server.heyrik.com/api/v1/calls

Headers

AuthorizationstringRequired

Use Bearer $HEYRIK_API_KEY with an account-scoped API key. Keep the key on your server.

Get your API key

Parameters 5

Fields documented for this operation. See the request example for placement and structure.

agent_idstring

Only this agent's calls (the agent id from POST /agents). `agency_id` also accepted.

directionstring

inbound | outbound.

statestring

Lifecycle stage: CREATED, ACTIVE, ENDED, FAILED. (The semantic result — NoAnswer, resolved, callback… — is the separate `outcome` field.)

fullboolean

full=1 includes the transcript, recording_url and summary on every row (heavier). Omit for slim rows.

page / limitnumber

Pagination — limit default 200, max 500.

Response

No response example is documented for this operation yet.

Error reference

GET/calls

cURL

# All calls
curl "https://server.heyrik.com/api/v1/calls?direction=outbound&limit=20" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"

# Just one agent's calls, with transcripts + recordings
curl "https://server.heyrik.com/api/v1/calls?agent_id=agc_9f2a1c30&full=1" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"

Illustrative examples · No live request is sent