API referenceGet call

Calls

Get call

Retrieve the complete record for a single call by its UUID. Returns the full call object including transcript, tool execution logs, analysis results, tags, and timing metadata. The call must belong to the project tied to your API key, otherwise a 404 is returned. Use this after you have a call_id from POST /api/ext/call/search, the analytics endpoint, or the response of a make-call request.

GET

https://api.nabrah.ai/api/ext/call/{call_id}

Get call

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/call/<call_id>' \
  --header 'X-API-Key: <your-api-key>'

{
  "id": "00000000-0000-4000-8000-000000000000",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "call_from": "string",
  "call_to": "string",
  "call_type": "inbound",
  "status": "queued",
  "call_started_at": "2026-01-15T12:00:00.000Z",
  "call_ended_at": "2026-01-15T12:00:00.000Z",
  "duration": 0,
  "agent_id": "00000000-0000-4000-8000-000000000000",
  "project_id": "00000000-0000-4000-8000-000000000000",
  "recording_file": "string",
  "transcript": [
    {}
  ],
  "agent_name": "string",
  "variables": {},
  "tool_logs": [
    {
      "executed_at": "2026-01-15T12:00:00.000Z",
      "name": "string",
      "success": false,
      "is_tool_deleted": false,
      "tool_id": "00000000-0000-4000-8000-000000000000",
      "arguments": {},
      "output": "string"
    }
  ],
  "analysis_results": [
    {
      "source": "system",
      "name": "string",
      "results": [
        {}
      ],
      "is_analysis_group_deleted": false,
      "analysis_group_id": "00000000-0000-4000-8000-000000000000"
    }
  ],
  "tags": [
    "string"
  ]
}

Where the call_id comes from

This endpoint needs a concrete call UUID. You can obtain one in several ways:

From a search

Call POST /api/ext/call/search and read calls[].id from the response.

id

From creating a call

POST /api/ext/call/make-call returns call_ids[]; use any of those values.

call_ids

Response shape (FullCall)

The 200 body is the complete call record. Key fields:

status

Current lifecycle state of the call. One of queued, ringing, in-progress, completed, failed, etc. A freshly created call typically starts as queued.

call_type

Direction of the call: inbound or outbound (web calls are also represented here).

transcript

Ordered list of conversation turns. Empty until the call has audio to transcribe.

transcript

tool_logs

Each entry records a tool invocation during the call: name, executed_at, success, the arguments passed, and the output returned. is_tool_deleted flags tools removed from the agent after the call.

executed_atnamesuccessis_tool_deletedtool_idargumentsoutput

analysis_results

Post-call analysis grouped by source (system or a custom analysis group). Each group lists its results and the originating analysis_group_id.

sourcenameresultsis_analysis_group_deletedanalysis_group_id

recording_file

Internal reference to the recording. To download the audio, call GET /api/ext/call/get-download-link/{call_id} for a temporary signed URL rather than using this field directly.

recording_file

duration is in seconds; call_started_at / call_ended_at are ISO-8601 timestamps and may be null for calls that never connected.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

call_idstringrequired

UUID of the call to fetch.

Obtain from POST /api/ext/call/search (calls[].id) or from the call_ids[] returned by POST /api/ext/call/make-call. Must belong to the project scoped by your API key.

Response

200

Successful Response

application/json

422

Validation Error

application/json

API referenceGet call

Calls

Get call

GET

https://api.nabrah.ai/api/ext/call/{call_id}

Get call

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/call/<call_id>' \
  --header 'X-API-Key: <your-api-key>'

{
  "id": "00000000-0000-4000-8000-000000000000",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "call_from": "string",
  "call_to": "string",
  "call_type": "inbound",
  "status": "queued",
  "call_started_at": "2026-01-15T12:00:00.000Z",
  "call_ended_at": "2026-01-15T12:00:00.000Z",
  "duration": 0,
  "agent_id": "00000000-0000-4000-8000-000000000000",
  "project_id": "00000000-0000-4000-8000-000000000000",
  "recording_file": "string",
  "transcript": [
    {}
  ],
  "agent_name": "string",
  "variables": {},
  "tool_logs": [
    {
      "executed_at": "2026-01-15T12:00:00.000Z",
      "name": "string",
      "success": false,
      "is_tool_deleted": false,
      "tool_id": "00000000-0000-4000-8000-000000000000",
      "arguments": {},
      "output": "string"
    }
  ],
  "analysis_results": [
    {
      "source": "system",
      "name": "string",
      "results": [
        {}
      ],
      "is_analysis_group_deleted": false,
      "analysis_group_id": "00000000-0000-4000-8000-000000000000"
    }
  ],
  "tags": [
    "string"
  ]
}

Where the call_id comes from

This endpoint needs a concrete call UUID. You can obtain one in several ways:

From a search

Call POST /api/ext/call/search and read calls[].id from the response.

id

From creating a call

POST /api/ext/call/make-call returns call_ids[]; use any of those values.

call_ids

Response shape (FullCall)

The 200 body is the complete call record. Key fields:

status

Current lifecycle state of the call. One of queued, ringing, in-progress, completed, failed, etc. A freshly created call typically starts as queued.

call_type

Direction of the call: inbound or outbound (web calls are also represented here).

transcript

Ordered list of conversation turns. Empty until the call has audio to transcribe.

transcript

tool_logs

Each entry records a tool invocation during the call: name, executed_at, success, the arguments passed, and the output returned. is_tool_deleted flags tools removed from the agent after the call.

executed_atnamesuccessis_tool_deletedtool_idargumentsoutput

analysis_results

Post-call analysis grouped by source (system or a custom analysis group). Each group lists its results and the originating analysis_group_id.

sourcenameresultsis_analysis_group_deletedanalysis_group_id

recording_file

Internal reference to the recording. To download the audio, call GET /api/ext/call/get-download-link/{call_id} for a temporary signed URL rather than using this field directly.

recording_file

duration is in seconds; call_started_at / call_ended_at are ISO-8601 timestamps and may be null for calls that never connected.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

call_idstringrequired

UUID of the call to fetch.

Obtain from POST /api/ext/call/search (calls[].id) or from the call_ids[] returned by POST /api/ext/call/make-call. Must belong to the project scoped by your API key.

Response

200

Successful Response

application/json

422

Validation Error

application/json