GET
/
v1
/
calls
curl --request GET \
  --url https://api.bland.ai/v1/calls \
  --header 'authorization: <authorization>'
{
    "count": 784,
    "calls": [
        {
            "call_id": "c1234567-89ab-cdef-0123-456789abcdef",
            "created_at": "2023-12-21T23:25:14.801193+00:00",
            "call_length": 0.834, // minutes
            "to": "5551234567",
            "from": "+15551234567",
            "completed": true,
            "queue_status": "complete",
            "error_message": null,
            "answered_by": "human",
            "batch_id": "b1234567-89ab-cdef-0123-gen-batch",
        },
        //... Additional call objects
    ]
}

Headers

authorization
string
required

Your API key for authentication.

Query Parameters

from_number
string

Filter calls by the number they were dispatched from.

The number that initiated the call - the user’s phone number for inbound calls, or the number your AI Agent called from for outbound calls.

to_number
string

Filter calls by the number they were dispatched to.

The number that answered the call - the user’s phone number for outbound calls, or your AI Agent’s number for inbound calls.

from
int

The starting index (inclusive) for the range of calls to retrieve.

to
int

The ending index for the range of calls to retrieve.

limit
int
default: "1000"

The maximum number of calls to return in the response.

ascending
boolean
default: "false"

Whether to sort the calls in ascending order of their creation time.

Response

count
integer

The total number of calls returned in the response.

calls
array

An array of call data objects. See the Call section for details.

Note: Individual call transcripts are not included due to their size.