Skip to main content
GET
Get Phone Call History

Authorizations

string
Bearer JWT used to authenticate the request.
string
Org API key. You can use this instead of JWT.

Query Parameters

string
required
Phone number in E.164 format. Example: +1234567890.
integer
Page number to return. Defaults to 1.
integer
Results per page. Defaults to 20 and maximum is 100.
boolean
Set to true to include transcripts in each call result.

Response

boolean
Whether the request succeeded.
string
Human-readable status message.
string
The phone number used for the lookup.
integer
Total number of matching calls.
integer
Current page number.
integer
Number of results returned per page.
array
Matching calls.

Authorizations

Authorization
string
header
required

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

Query Parameters

phone
string
required

Phone number in E.164 format. Example: +1234567890.

page
integer
default:1

Page number. Defaults to 1.

page_size
integer
default:20

Results per page. Defaults to 20. Maximum 100.

Required range: x <= 100
include_transcripts
boolean

Set to true to include transcripts in each call result.

Response

call history retrieved successfully

success
boolean
Example:

true

message
string
Example:

"call history retrieved successfully"

phone
string
Example:

"+919876543210"

total_count
integer
Example:

3

page
integer
Example:

1

page_size
integer
Example:

20

calls
object[]