Get Outbound Call Status

Retrieves the current status and details of a previously created outbound call. The id in the URL path is the outboundCallId returned when the call was created. Requires a tenant or organization-level API key for authentication.

Poll this endpoint after creating an outbound call to track whether it is still in progress or has reached a terminal state. Terminal states are completed, failed, busy, and no-answer. The callDetails object is only present once the call has reached a terminal state.

Headers

Authorization

string

required

API key is required. Enter either your tenant-specific or organization-specific API key in the format Bearer YOUR-API-KEY

Path Parameters

string

required

The outbound call ID (outboundCallId) returned from the Create Outbound Call endpoint.

Response

outboundCallId

string

UUID identifying the outbound call.

contactId

string

UUID of the contact associated with this outbound call.

status

string

Current status of the outbound call. Possible values:

Status	Description
`calling`	The call has been dispatched and is in progress
`completed`	The call connected and ended normally
`failed`	The call could not be completed due to an error
`busy`	The destination number was busy
`no-answer`	The call rang but was not answered

callDetails

object

Present only when the call has reached a terminal state (completed, failed, busy, or no-answer).

Show properties

startedAt

string

ISO 8601 timestamp when the call started (e.g., "2026-04-01T14:30:00Z"). null if the call never connected.

endedAt

string

ISO 8601 timestamp when the call ended (e.g., "2026-04-01T14:32:30Z").

duration

integer

Call duration in seconds. null if the call never connected.

endedReason

string

Reason the call ended (e.g., "customer-ended-call").

Example Request

curl -X GET https://allomia.com/api/outbound/c3d4e5f6-a7b8-9012-cdef-345678901234/status \
  -H "Authorization: Bearer YOUR-API-KEY"

Example Response — Call In Progress

{
  "outboundCallId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "contactId": "d4e5f6a7-b8c9-0123-defa-456789012345",
  "status": "calling",
  "callDetails": null
}

Example Response — Call Completed

{
  "outboundCallId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "contactId": "d4e5f6a7-b8c9-0123-defa-456789012345",
  "status": "completed",
  "callDetails": {
    "startedAt": "2026-04-01T14:30:00Z",
    "endedAt": "2026-04-01T14:32:30Z",
    "duration": 150,
    "endedReason": "customer-ended-call"
  }
}

Example Response — Call Failed (no answer)

{
  "outboundCallId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "contactId": "d4e5f6a7-b8c9-0123-defa-456789012345",
  "status": "no-answer",
  "callDetails": {
    "startedAt": null,
    "endedAt": "2026-04-01T14:30:45Z",
    "duration": null,
    "endedReason": "no-answer"
  }
}

Error Responses

401: Unauthorized

Returned when the API key is missing or invalid.

{
  "error": "Invalid or missing API key"
}

404: Outbound call not found

Returned when no outbound call exists for the provided ID, or the call does not belong to the organization associated with the API key.

{
  "error": "Outbound call not found"
}

500: Internal server error

{
  "error": "Internal server error occurred"
}

Documentation Index