Skip to main content
GET
/
api
/
v1
/
calls
/
{call_id}
cURL
curl --request GET \
  --url https://kapi.prod1.kastle.ai/api/v1/calls/{call_id} \
  --header 'Authorization: Bearer <token>'
{
  "summarizations": {
    "call_summary": "Customer called about loan refinancing options",
    "three_word_summary": "Refinancing"
  },
  "extracted_vars": {
    "rpc": true,
    "payment_amount": 1234.56,
    "payment_due_date": "2024-01-01"
  },
  "call_transcript": [
    {
      "role": "assistant",
      "content": "Hello, this is Kastle. How can I help you today?"
    },
    {
      "role": "user",
      "content": "Hi, I'm calling about refinancing my loan."
    }
  ],
  "call_id": "<string>",
  "from_number": "+19098765432",
  "to_number": "+19876543210",
  "call_duration": 123,
  "call_status": "ai_ended_call",
  "call_time": 123,
  "loan_id": "1234567890",
  "order_id": "1234567890",
  "call_reason": "Refinance Inquiry",
  "transfer_reason": "Loan Payoff Request"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
call_id
string
required

Unique identifier of the call to retrieve

Response

Successfully retrieved call details

​
summarizations
object
required

Various types of call summarizations

Example:
{
  "call_summary": "Customer called about loan refinancing options",
  "three_word_summary": "Refinancing"
}
​
extracted_vars
object
required

Key variables extracted from the call

Example:
{
  "rpc": true,
  "payment_amount": 1234.56,
  "payment_due_date": "2024-01-01"
}
​
call_transcript
object[]
required

Full transcript of the call in OpenAI chat format

Example:
[
  {
    "role": "assistant",
    "content": "Hello, this is Kastle. How can I help you today?"
  },
  {
    "role": "user",
    "content": "Hi, I'm calling about refinancing my loan."
  }
]
​
call_id
string

Unique identifier for the call

​
from_number
string

Phone number that initiated the call

Example:

"+19098765432"

​
to_number
string

Phone number that received the call

Example:

"+19876543210"

​
call_duration
integer

Duration of the call in seconds

​
call_status
enum<string>

Status of the call

Available options:
ai_ended_call,
user_ended_call,
transferred,
voicemail,
no_answer,
failed
​
call_time
integer<int64>

Unix timestamp when the call was initiated

​
loan_id
string

(Optional) Identifier for the associated loan (if the call is associated with a borrower with a specific loan)

Example:

"1234567890"

​
order_id
string

(Optional) Identifier for the associated order (if the call is associated with an appraisal order)

Example:

"1234567890"

​
call_reason
string

Reason for the call as determined by the AI

Example:

"Refinance Inquiry"

​
transfer_reason
string

(Optional) Reason the call was transferred as determined by the AI. This field is only present if the call was transferred.

Example:

"Loan Payoff Request"