Get Call

Path parameters

idstringRequired

Headers

AuthorizationstringRequired

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

Response

idstring

This is the unique identifier for the call.

orgIdstring

This is the unique identifier for the org that this call belongs to.

createdAtdatetime

This is the ISO 8601 date-time string of when the call was created.

updatedAtdatetime

This is the ISO 8601 date-time string of when the call was last updated.

typeenumOptional

This is the type of call.

Allowed values:
costslist of objectsOptional

These are the costs of individual components of the call in USD.

messageslist of objectsOptional
phoneCallTransportenumOptional

This is the transport of the phone call.

Only relevant for outboundPhoneCall and inboundPhoneCall type.

Allowed values:
statusenumOptional

This is the status of the call.

endedReasonenumOptional

This is the explanation for how the call ended.

destinationobjectOptional

This is the destination where the call ended up being transferred to. If the call was not transferred, this will be empty.

startedAtdatetimeOptional

This is the ISO 8601 date-time string of when the call was started.

endedAtdatetimeOptional

This is the ISO 8601 date-time string of when the call was ended.

costdoubleOptional

This is the cost of the call in USD.

costBreakdownobjectOptional

This is the cost of the call in USD.

artifactPlanobjectOptional

This is a copy of assistant artifact plan. This isn’t actually stored on the call but rather just returned in POST /call/web to enable artifact creation client side.

analysisobjectOptional

This is the analysis of the call. Configure in assistant.analysisPlan.

monitorobjectOptional

This is to real-time monitor the call. Configure in assistant.monitorPlan.

artifactobjectOptional

These are the artifacts created from the call. Configure in assistant.artifactPlan.

assistantIdstringOptional

This is the assistant that will be used for the call. To use a transient assistant, use assistant instead. Usage: To start the call with Assistant as entrypoint, use assistant or assistantId To start the call with Squad as entrypoint, use squad or squadId To start the call with Workflow as entrypoint, use workflow or workflowId

assistantobjectOptional

This is the assistant that will be used for the call. To use an existing assistant, use assistantId instead. Usage: To start the call with Assistant as entrypoint, use assistant or assistantId To start the call with Squad as entrypoint, use squad or squadId To start the call with Workflow as entrypoint, use workflow or workflowId

assistantOverridesobjectOptional

These are the overrides for the assistant or assistantId’s settings and template variables.

squadIdstringOptional

This is the squad that will be used for the call. To use a transient squad, use squad instead. Usage: To start the call with Assistant as entrypoint, use assistant or assistantId To start the call with Squad as entrypoint, use squad or squadId To start the call with Workflow as entrypoint, use workflow or workflowId

squadobjectOptional

This is a squad that will be used for the call. To use an existing squad, use squadId instead. Usage: To start the call with Assistant as entrypoint, use assistant or assistantId To start the call with Squad as entrypoint, use squad or squadId To start the call with Workflow as entrypoint, use workflow or workflowId

workflowIdstringOptional

This is the workflow that will be used for the call. To use a transient workflow, use workflow instead. Usage: To start the call with Assistant as entrypoint, use assistant or assistantId To start the call with Squad as entrypoint, use squad or squadId To start the call with Workflow as entrypoint, use workflow or workflowId

workflowobjectOptional

This is a workflow that will be used for the call. To use an existing workflow, use workflowId instead. Usage: To start the call with Assistant as entrypoint, use assistant or assistantId To start the call with Squad as entrypoint, use squad or squadId To start the call with Workflow as entrypoint, use workflow or workflowId

phoneNumberIdstringOptional

This is the phone number that will be used for the call. To use a transient number, use phoneNumber instead.

Only relevant for outboundPhoneCall and inboundPhoneCall type.

phoneNumberobjectOptional

This is the phone number that will be used for the call. To use an existing number, use phoneNumberId instead.

Only relevant for outboundPhoneCall and inboundPhoneCall type.

customerIdstringOptional

This is the customer that will be called. To call a transient customer , use customer instead.

Only relevant for outboundPhoneCall and inboundPhoneCall type.

customerobjectOptional

This is the customer that will be called. To call an existing customer, use customerId instead.

Only relevant for outboundPhoneCall and inboundPhoneCall type.

namestringOptional<=40 characters

This is the name of the call. This is just for your own reference.

schedulePlanobjectOptional

This is the schedule plan of the call.

transportmap from strings to anyOptional

This is the transport of the call.

phoneCallProviderenumOptionalDeprecated

This is the provider of the call.

Only relevant for outboundPhoneCall and inboundPhoneCall type.

Allowed values:
phoneCallProviderIdstringOptionalDeprecated

The ID of the call as provided by the phone number service. callSid in Twilio. conversationUuid in Vonage. callControlId in Telnyx.

Only relevant for outboundPhoneCall and inboundPhoneCall type.