Get Individual Call Status

GEThttps://api.trillet.ai/v1/api/batch-calls/{batchId}/calls/{jobId}

Headers

x-api-keystringrequired

API key used for authenticating requests to the API.

x-workspace-idstringrequired

Workspace identifier for the API.

Path Parameters

batchIdstringrequired

The unique identifier of the batch call operation

jobIdstringrequired

The unique identifier of the individual call job

Response

jobIdstring

The unique identifier of the call job

statusstring

Current status of the individual call

waiting - Call is queued and waiting to be processed
active - Call is currently in progress
completed - Call completed successfully
failed - Call failed due to an error

phone_numberstring

The phone number that was called

startTimenumber

Timestamp when the call started (if applicable)

endTimenumber

Timestamp when the call ended (if completed or failed)

durationnumber

Duration of the call in seconds (if completed)

errorstring

Error message if the call failed

resultobject

Call result data including conversation details (if completed)

Example Usage

curl -X GET "https://api.trillet.ai/v1/api/batch-calls/batch_7891011121314/calls/call_123" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-workspace-id: YOUR_WORKSPACE_ID"

Example Response (Completed Call)

{
  "jobId": "call_123",
  "status": "completed",
  "phone_number": "+1234567890",
  "startTime": 1703097600000,
  "endTime": 1703097642000,
  "duration": 42,
  "result": {
    "callId": "call_abc123",
    "transcript": "Hello John, this is an automated call...",
    "outcome": "successful",
    "metadata": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com"
    }
  }
}

Example Response (Failed Call)

{
  "jobId": "call_124",
  "status": "failed",
  "phone_number": "+1987654321",
  "startTime": 1703097600000,
  "endTime": 1703097615000,
  "error": "Number busy - unable to connect after 3 attempts"
}

Example Response (Active Call)

{
  "jobId": "call_125",
  "status": "active",
  "phone_number": "+1555666777",
  "startTime": 1703097700000
}

Error Responses

statusstring

Will be "not_found" if the call doesn't exist

errorstring

Error message describing what went wrong

Common Error Codes:

404 - Call not found with the specified job ID
500 - Server error retrieving call status

Use Cases

Monitor individual call progress within a batch
Retrieve detailed results for completed calls
Debug failed calls to understand failure reasons
Track call timing and duration metrics