Get Call

GET

calls

{id}

Headers

authorization

string

required

Your API key for authentication. Use Bearer format.

Path Parameters

string

required

ID of the call.

Required string length: 24

Response

200 - application/json

agent

object

required

Agent that handled the call.

created

string

required

Date the call was created.

string

required

Unique identifier for the call.

language

enum<string>

required

Language of the call.

Available options:

en-US,

en-GB,

es-MX,

es-ES,

pt-PT,

de-DE,

fr-FR,

pl-PL,

ro-RO,

it-IT

metadata

object

required

Call metadata.

organization_id

string

required

Organization ID.

provider

enum<string>

required

Provider of the call.

Available options:

Twilio,

Web,

Chat

status

enum<string>

required

Status of the call.

Available options:

Scheduled,

Queued,

Initiated,

Ringing,

In progress,

Transferred,

Completed,

AMD Terminated,

Busy,

No answer,

Canceled,

Failed

type

enum<string>

required

Type of the call.

Available options:

Inbound,

Outbound

use_case

object

required

Use case that handled the call.

use_case.id

string

required

ID of the use case.

use_case.model

string

required

Model name.

use_case.organization_id

string

required

ID of the organization that owns the use case.

use_case.amd

boolean

Enable automatic machine detection. This is a prerequisite to end calls on machines or for Phone Tree Navigation.

use_case.amd_behavior

enum<string>

AI assistant behavior when AMD is enabled. Continue is used for Phone Tree Navigation, Hangup to end the call and Message to leave a message. If amd is set, this field is required.

Available options:

Hangup,

Continue,

Message

use_case.amd_messages

object

Record of messages to leave on voicemail if amd_behavior is set to Message. You may use parameters as you do in the prompt for templating. The key is the language of the message and the value is the message.

use_case.classification_tags

object[]

Classification tags for the use case.

use_case.detailed_work_hours

object

Detailed work hours for each day of the week.

use_case.enable_detailed_work_hours

boolean

Enable detailed work hours in the UI.

use_case.evaluation_models

string[]

Models the use case is evaluated on.

use_case.extract_with_ai

object[]

Parameters to extract with AI.

use_case.generic_after_hours_message

string

Generic message to play if the call is after hours.

use_case.hidden

boolean

Hide the use case from the UI.

use_case.hooks

object[] | null

Webhooks to call when the use case is executed.

use_case.keywords

string[]

Keywords you want the transcriber to know about.

use_case.language

enum<string>

default:

en-US

Preferred language for the use case.

Available options:

en-US,

en-GB,

es-MX,

es-ES,

pt-PT,

de-DE,

fr-FR,

pl-PL,

ro-RO,

it-IT

use_case.max_duration_mins

integer

Specifies the maximum duration in minutes for this use-case. This value is overridden by the maximum duration specified for individual calls. If neither is provided, the default duration is 10 minutes.

use_case.name

string

Name of the use case.

use_case.params

object

Parameters to pass to the use case.

use_case.recorded_message_inbound

boolean

Play 'This call is being recorded' message for inbound calls.

use_case.recorded_message_outbound

boolean

Play 'This call is being recorded' message for outbound calls.

use_case.sample_labels

object[]

Available labels for the samples.

use_case.show_original_caller_id

boolean

Show the original caller ID on the call screen.

use_case.timezone

string

Timezone of the use case.

use_case.transfer_number

string

Fallback phone number to transfer the call to if something breaks.

use_case.work_end

string

End of the work hours.

use_case.work_start

string

Start of the work hours.

viewed_by

string[]

required

User emails that have viewed the call in the Happyrobot App.

campaign_id

string

Campaign ID.

classification

object

Tag classification of the call.

costs

object

Costs associated with the call.

duration

number

Duration of the call in seconds.

extraction

object

AI extracted data from the call.

max_duration_mins

integer

Specifies the maximum duration of the call in minutes. This value takes precedence over the maximum duration specified in the use-case. If neither is provided, the default duration is 10 minutes.

notes

object[]

Notes associated with the call.

params

object

Dynamic parameters to inject into the templated use case prompt.

parent_call_id

string

Parent call ID in the case of repeated calls.

prompt_id

string

Prompt ID.

ratings

object[]

Ratings emojis associated with the call.

samples

string[]

Sample IDs that are associated with the call.

scheduled_for

string

ISO 8601 UTC datetime the call is scheduled for.

transfer_contact_email

string

Email of the transfer contact.

use_backup

boolean

Whether the backup model was used.

wait_until_awake

boolean

Whether the call should wait until the model is awake.

Was this page helpful?

Get Calls Get Transcript

Basic

Calls

Tools

Dial

Orgs

Numbers

Voices

Models

Usecases

Agents

Analytics

Headers

Path Parameters

Response