GET
/
v1
/
api
/
batch-calls
/
{batchId}
/
calls
/
{jobId}
Get Individual Call Status
curl --request GET \
  --url https://api.trillet.ai/v1/api/batch-calls/{batchId}/calls/{jobId} \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
{
  "jobId": "<string>",
  "status": "<string>",
  "phone_number": "<string>",
  "startTime": 123,
  "endTime": 123,
  "duration": 123,
  "error": "<string>",
  "result": {}
}

Headers

x-api-key
string
required
API key used for authenticating requests to the API.
x-workspace-id
string
required
Workspace identifier for the API.

Path Parameters

batchId
string
required
The unique identifier of the batch call operation
jobId
string
required
The unique identifier of the individual call job

Response

jobId
string
The unique identifier of the call job
status
string
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_number
string
The phone number that was called
startTime
number
Timestamp when the call started (if applicable)
endTime
number
Timestamp when the call ended (if completed or failed)
duration
number
Duration of the call in seconds (if completed)
error
string
Error message if the call failed
result
object
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

status
string
Will be “not_found” if the call doesn’t exist
error
string
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