Calls & Logs

Use these endpoints to inspect what your agents did on calls: recent call history, per-call transcripts and tool invocations, and agent runtime logs for debugging webhook and tool issues.

All endpoints on this page use API key authentication:

Authorization: Bearer $ORBITALI_API_KEY

Public call and log endpoints

Method	Path	Description
GET	/public/v1/calls	List recent call history
GET	/public/v1/calls/{call_id}	Get one call with transcript and tool usage
GET	/public/v1/agents/{agent_id}/logs	List an agent's runtime logs (last 24 hours)

List calls

Returns the organization's recent call history, newest first.

Query parameters:

Parameter	Type	Description
agentId	UUID	Optional. Only return calls for this agent
limit	number	Optional. 1-100, defaults to 25

curl "https://api.orbitali.ai/public/v1/calls?agentId=$AGENT_ID&limit=25" \
  -H "Authorization: Bearer $ORBITALI_API_KEY"

Response:

[
  {
    "id": "7c1a9a1e-3f42-4a52-9f0d-6a1f9d1b2c3e",
    "agentName": "Receptionist",
    "fromNumber": "+15550002000",
    "toNumber": "+15550001000",
    "status": "completed",
    "durationSeconds": 184,
    "startedAt": "2026-05-15T12:00:00.000Z",
    "toolInvocations": 2,
    "usageCostEur": 0.33
  }
]

status is one of completed, active, or failed.

Get call detail

Returns one call with its summary, transcript messages, tool invocations, and LLM usage.

curl https://api.orbitali.ai/public/v1/calls/$CALL_ID \
  -H "Authorization: Bearer $ORBITALI_API_KEY"

Response:

{
  "id": "7c1a9a1e-3f42-4a52-9f0d-6a1f9d1b2c3e",
  "agentName": "Receptionist",
  "fromNumber": "+15550002000",
  "toNumber": "+15550001000",
  "status": "completed",
  "durationSeconds": 184,
  "startedAt": "2026-05-15T12:00:00.000Z",
  "toolInvocations": 1,
  "usageCostEur": 0.33,
  "summary": "Caller asked about a delayed order and received a delivery update.",
  "messages": [
    {
      "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
      "role": "user",
      "content": "Where is my order?",
      "occurredAt": "2026-05-15T12:00:05.000Z"
    }
  ],
  "toolInvocationsLog": [
    {
      "id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
      "agentToolId": "0e39f640-c46a-4cb8-a0a7-2a12df513b37",
      "toolName": "lookup_order",
      "request": { "orderId": "A-1042" },
      "response": "{\"status\":\"shipped\"}",
      "status": "success",
      "durationMs": 420,
      "createdAt": "2026-05-15T12:00:10.000Z"
    }
  ],
  "llmUsage": []
}

Call transcripts contain caller speech and can include personal data. Handle exported transcripts according to your privacy policy and retention rules.

List agent logs

Returns the agent's runtime logs from the last 24 hours, newest first. Use these to debug webhook timeouts, tool failures, and session issues.

Query parameters:

Parameter	Type	Description
limit	number	Optional. 1-100, defaults to 25
offset	number	Optional. Number of entries to skip for pagination
severity	string	Optional. One of debug, info, warn, error
sessionId	string	Optional. 6-character session ID to filter a single call

curl "https://api.orbitali.ai/public/v1/agents/$AGENT_ID/logs?severity=error&limit=25" \
  -H "Authorization: Bearer $ORBITALI_API_KEY"

Response:

{
  "logs": [
    {
      "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "accountId": "30000000-0000-4000-8000-000000000001",
      "agentId": "9dbf0d0b-2b55-45de-8c41-7a2d9b0ce8e9",
      "sessionId": "a1b2c3",
      "timestamp": "2026-05-15T12:00:00.000Z",
      "severity": "error",
      "content": { "message": "Webhook timed out after 10000ms" }
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}

Errors

Status	Description
401	Missing, malformed, or invalid API key
400	Invalid query parameters; the response includes validation issues
404	Call or agent does not exist or belongs to another organization