GET
/
v1
/
calls
/
{id}
curl --request GET \
  --url https://api.langcall.com/v1/calls/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "created_at": "<string>",
  "direction": "inbound",
  "duration": 123,
  "conversations": [
    {
      "role": "assistant",
      "content": "<string>"
    }
  ],
  "type": "full_ai",
  "to_number": "+1234567890",
  "instruction": "Get a home loan certificate and send it to a@a.com",
  "transfer_number": "+0987654321",
  "voice_id": "aura-asteria-en",
  "status_callback": "https://webhook.site/97f897b1-288d-4772-9a6e-11111"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

ID of the call to get

Response

200
application/json
Call response
​
type
enum<string>
required

Type of the call

Available options:
full_ai,
transfer
Example:

"full_ai"

​
to_number
string
required

Number to call. Phone numbers should be formatted in E.164 format with a + and country code, for example: +16175551212.

Example:

"+1234567890"

​
instruction
string
required

Detailed instruction for the call

Example:

"Get a home loan certificate and send it to a@a.com"

​
id
string

Identification number of the call

​
created_at
string

Time when the call was started in ISO 8601 standard, e.g. 2024-09-25T22:22:08.095646+00:00

​
direction
enum<string>

Direction of the call: inbound or outbound

Available options:
inbound,
outbound
​
duration
number

Duration of the call in minutes

​
conversations
object[]

A list of messages comprising the phone conversation so far

​
transfer_number
string

Required if the call type is “transfer.” If you need to include an extension, separate the number and extension with a comma. For example: +0987654321,123.

Example:

"+0987654321"

​
voice_id
string

Voice ID to use for the call.

Example:

"aura-asteria-en"

​
status_callback
string | null

Webhook URL to be called when the call status is updated.

Example:

"https://webhook.site/97f897b1-288d-4772-9a6e-11111"