One call — transcript, recording, outcome, cost

GEThttps://server.heyrik.com/api/v1/calls/{id}

Path parameters

idRequired

Replace {id} in the request URL with the value for this resource.

Headers

AuthorizationstringRequired

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

Get your API key

Response

Explore the example values. This is not a complete response schema.

dataobject

Explore 13 properties

idstring

Example "call_1dd990f7"

agency_idstring

Example "agc_9f2a1c30"

directionstring

Example "inbound"

statestring

Example "ENDED"

caller_idstring

Example "+919392780218"

started_atstring

Example "2026-07-22T15:05:45.674Z"

ended_atstring

Example "2026-07-22T15:06:22.113Z"

duration_secnumber

Example 37

recording_urlstring

Example "https://…/recordings/call_1dd990f7.mp3"

transcriptarray

Explore 2 example items

[0]object

Explore 3 properties

rolestring

Example "assistant"

contentstring

Example "Hi, thanks for calling Acme — how can I help?"

tsstring

Example "…"

[1]object

Explore 3 properties

rolestring

Example "user"

contentstring

Example "I want to check my order status."

tsstring

Example "…"

summarystring

Example "Caller asked about order AC-8842; agent confirmed dispatch."

outcomestring

Example "resolved"

credits_chargednumber

Example 2.9167

Error reference

GET/calls/{id}

cURL

curl https://server.heyrik.com/api/v1/calls/call_1dd990f7 \
  -H "Authorization: Bearer $HEYRIK_API_KEY"

Response example

JSON

{
  "data": {
    "id": "call_1dd990f7",
    "agency_id": "agc_9f2a1c30",
    "direction": "inbound",
    "state": "ENDED",
    "caller_id": "+919392780218",
    "started_at": "2026-07-22T15:05:45.674Z",
    "ended_at": "2026-07-22T15:06:22.113Z",
    "duration_sec": 37,
    "recording_url": "https://…/recordings/call_1dd990f7.mp3",
    "transcript": [
      { "role": "assistant", "content": "Hi, thanks for calling Acme — how can I help?", "ts": "…" },
      { "role": "user", "content": "I want to check my order status.", "ts": "…" }
    ],
    "summary": "Caller asked about order AC-8842; agent confirmed dispatch.",
    "outcome": "resolved",
    "credits_charged": 2.9167
  }
}

Illustrative examples · No live request is sent