GET/2010-04-01/Accounts/{AccountSid}/Calls.json

List calls for an account

Lists calls made to and from a specified account. Filter the results by caller, recipient, parent call, status, or start and end times. Use the page parameters to navigate through the results.

14 parameters
AccountSidstringrequired
The SID of the account that created the calls to retrieve. Must match the account SID format: 34 characters beginning with AC followed by 32 hexadecimal characters.
Tostringoptional
Filter for calls made to this phone number, SIP address, client identifier, or SIM SID.
Fromstringoptional
Filter for calls made from this phone number, SIP address, client identifier, or SIM SID.
ParentCallSidstringoptional
Filter for calls spawned by the specified parent call. Must match the call SID format: 34 characters beginning with CA followed by 32 hexadecimal characters.
Statusstringoptional
Filter by call status: queued, ringing, in-progress, completed, busy, failed, no-answer, or canceled.
Allowed:queuedringingin-progresscompletedbusyfailedno-answercanceled
StartTimestringoptional
Filter for calls that started on the specified UTC date.
StartTime<stringoptional
Filter for calls that started before the specified UTC date.
StartTime>stringoptional
Filter for calls that started on or after the specified UTC date.
EndTimestringoptional
Filter for calls that ended on the specified UTC date.
EndTime<stringoptional
Filter for calls that ended before the specified UTC date.
EndTime>stringoptional
Filter for calls that ended on or after the specified UTC date.
PageSizeintegeroptional
Number of resources to return per page. Defaults to 50 when omitted; must be between 1 and 1000.
Pageintegeroptional
Page index for client state. Must be zero or greater.
PageTokenstringoptional
Token supplied by the API to identify a page of results.

1 status code
200Returns a paginated response containing call objects and page metadata, including page size, page index, and navigation URIs.
endintegeroptional
first_page_uristringoptional
next_page_uristringoptional
pageintegeroptional
page_sizeintegeroptional
previous_page_uristringoptional
startintegeroptional
uristringoptional
callsarray<object>optional

Error handling

The AccountSid path parameter must match the account SID format, and ParentCallSid must match the call SID format. Status must be one of queued, ringing, in-progress, completed, busy, failed, no-answer, or canceled; date filters must use the documented date format. PageSize must be between 1 and 1000, and Page must be zero or greater.