GET
/
v1
/
calls
/
{call_id}
curl --request GET \
  --url https://api.bland.ai/v1/calls/{call_id} \
  --header 'authorization: <authorization>'
{
    "status": "completed",
    "corrected_duration": "71",
    "end_at": "2023-12-16T00:15:41.000Z",
    "call_id": "c1234567-89ab-cdef-0123-456789abcdef",
    "to": "5551234567",
    "from": "+15551234567",
    "completed": true,
    "created_at": "2023-12-16T00:15:26.59585+00:00",
    "queue_status": "complete",
    "endpoint_url": "api.bland.ai",
    "max_duration": 30,
    "error_message": null,
    "answered_by": "human",
    "batch_id": null,
    "variables": {
        "appointment_time": "tomorrow at 3pm",
        "now": "Sun Dec 31 2023 19:15:26 GMT+0000 (Coordinated Universal Time)",
        "short_from": "5551234567",
        "short_to": "5551234567",
        "from": "+15551234567",
        "to": "+15551234567",
        "call_id": "c1234567-89ab-cdef-0123-456789abcdef"
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "zip": "94103"
    },
    "concatenated_transcript": "user : Hey, it's Alex. What's up? \n assistant: Hi! It's Blandie, calling to reschedule your appointment tomorrow. Is now a good time? \n user: Sure! Can we still fit it in this week though? \n assistant: Absolutely! I have a few openings. What time works best for you? \n user: How about tomorrow at 3pm? \n assistant: Perfect! Be on the lookout for a confirmation email with your new appointment time, and have a great day!",
    "request_data": {
        "phone_number": "5551234567",
        "reduce_latency": false,
        "wait": false,
        "language": "ENG"
    },
    "transcripts": [
        {
            "id": 123456,
            "created_at": "2023-12-16T00:15:32.287493+00:00",
            "text": "Hey, it's Alex. What's up?",
            "user": "user",
            "c_id": "c1234567-89ab-cdef-0123-456789abcdef"
        },
        {
            "id": 123457,
            "created_at": "2023-12-16T00:15:33.704238+00:00",
            "text": "Hi! It's Blandie, calling to reschedule your appointment tomorrow. Is now a good time?",
            "user": "assistant",
            "c_id": "c1234567-89ab-cdef-0123-456789abcdef"
        },
        {
            "id": 123458,
            "created_at": "2023-12-16T00:15:38.287493+00:00",
            "text": "Sure! Can we still fit it in this week though?",
            "user": "user",
            "c_id": "c1234567-89ab-cdef-0123-456789abcdef"
        },
        //... continued ...
        {
            "id": 123458,
            "created_at": "2023-12-16T00:16:39.802469+00:00",
            "text": "Ended call: Perfect! Be on the lookout for a confirmation email with your new appointment time, and have a great day!",
            "user": "agent-action",
            "c_id": "c1234567-89ab-cdef-0123-456789abcdef"
        }
    ],
    "call_length": 0.111
}

Headers

authorization
string
required

Your API key for authentication.

Path Parameters

call_id
string
required

The unique identifier of the call for which you want to retrieve detailed information.

Response

transcripts
array of objects

An array of phrases spoken during the call.

Each index includes:

  • id
  • created_at
  • text
  • user (can be user, assistant, robot, or agent-action)
c_id
number

The unique identifier for the call.

variables
object

Variables created during the call - both system variables as well as generated with dynamic_data.

For example, if you used a dynamic_data API request to generate a variable called appointment_time, you would see it here.

concatenated_transcript
string

A single string containing all of the text from the call. Excludes system messages and auto-generated data.

to
string

The phone number that received the call.

from
string

The phone number that made the call.

batch_id
string

If the call is part of a batch, it’s batch_id will be here.

request_data
object

Details about parameters in the original api request.

completed
boolean

Whether the call has been completed. If it differs from the value of ‘queue_status’, this will be the most up-to-date status.

queue_status
string

The status of the call. During extremely high volume periods, calls may be queued for a short period of time before being dispatched.

Progresses through the following stages:

  • new: An API request has been received.
  • queued: Call pararameters have been validated and authentication succeeded.
  • allocated: Extremely brief, the call is being dispatched.
  • started: The phone call is live and in progress.
  • complete: The phone call has ended successfully.

The following statuses show the point that was reached before an error:

  • pre_queue_error: An error occurred before the call was queued. Invalid parameters generally cause this.
  • queue_error: Error occurred while the call was queued. Ex. Valid phone number but to an unserviced area.
  • call_error: Error occurred during live call. May be caused by transferring to an invalid phone number or an unforeseen error.
  • complete_error: Error occurred after the call was completed. Ex. A post-call webhook failed.

If at any point an error occurs, it will be recorded in the error_message field.

error_message
string or null

If an error occurs, this will contain a description of the error. Otherwise, it will be null.

answered_by
string

If answered_by_enabled was set to true in the original API request, this field contains one of the following values:

  • human: The call was answered by a human.
  • voicemail: The call was answered by an answering machine or voicemail.
  • unknown: There was not enough audio at the start of the call to make a determination.
  • no-answer: The call was not answered.
  • null: Not enabled, or still processing the result.
endpoint_url
string

The URL that was called to dispatch the phone call.

max_duration
number

The maximum length of time the call was allowed to last. If the call would exceed this length, it’s ended early.

corrected_duration
number

The total length of time the call was connected. This differs from call_length in that it includes ringing and connection time.

call_length
number

The length of the call in minutes.

created_at
string

The timestamp for when the call was dispatched.