Skip to main content
GET
/
v1
/
calls
/
{id}
Get call
curl --request GET \
  --url https://api.vatel.ai/v1/calls/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "graph_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "party_number": "<string>",
  "status": "connected",
  "source": "twilio",
  "termination_reason": "<string>",
  "extracted_variables": [
    {
      "name": "<string>",
      "type": "system",
      "description": "<string>",
      "value": "<unknown>",
      "dataType": "string",
      "rationale": "<string>"
    }
  ],
  "outbound": true,
  "outbound_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "outbound_list_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "<string>",
  "connected_at": "<string>",
  "started_at": "<string>",
  "ended_at": "<string>",
  "summary": "<string>",
  "transcript": {
    "entries": [
      {
        "index": 123,
        "role": "<string>",
        "message": "<string>",
        "type": "message",
        "toolCall": {
          "itemId": "<string>",
          "callId": "<string>",
          "toolName": "<string>",
          "arguments": "<string>",
          "output": "<string>",
          "startedAt": "2023-11-07T05:31:56Z",
          "endedAt": "2023-11-07T05:31:56Z"
        },
        "toolCallOutput": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "durationMs": 123,
        "turnId": "<string>"
      }
    ]
  },
  "cost": 123,
  "tags": [
    "<string>"
  ],
  "duration_seconds": 123
}

Authorizations

Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Path Parameters

id
string<uuid>
required

Call id

Response

Call

Public call record. cost is the customer-facing (marked-up) total; raw provider cost is not exposed.

id
string<uuid>
agent_id
string<uuid>
graph_version_id
string<uuid>
organization_id
string<uuid>
party_number
string
status
enum<string>

Call lifecycle status.

Available options:
connected,
started,
in_progress,
auth_failed,
ended
source
enum<string>

How the call entered the platform.

Available options:
twilio,
sip,
simulation,
api
termination_reason
string
extracted_variables
object[]
outbound
boolean
outbound_contact_id
string<uuid>
outbound_list_run_id
string<uuid>
created_at
string

RFC3339 timestamp

connected_at
string

RFC3339 timestamp when present

started_at
string

RFC3339 timestamp when present

ended_at
string

RFC3339 timestamp when present

summary
string
transcript
object

Conversation transcript. Omitted when not stored for the call.

cost
number

Marked-up total cost for the call.

tags
string[]
duration_seconds
integer

Approximate duration from started_at to ended_at when both are set.