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

List calls for an Account

Lists calls made to and from an Account, with optional filters for participants, parent call, status, dates, and pagination. Use the call-status and date filters to narrow the collection, and use the returned page token to retrieve another page.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

14 parameters
AccountSidstringrequired
The 34-character SID of the Account whose calls you want to list, matching the `AC` prefix and 32 hexadecimal characters.
Tostringoptional
Include only calls made to the specified phone number, SIP address, Client identifier, or SIM SID; phone numbers use phone-number format.
Fromstringoptional
Include only calls from the specified phone number, SIP address, Client identifier, or SIM SID; phone numbers use phone-number format.
ParentCallSidstringoptional
Include only calls spawned by the specified Call SID, matching the `CA` prefix and 32 hexadecimal characters.
Statusstringoptional
Filter by call status: `queued`, `ringing`, `in-progress`, `completed`, `busy`, `failed`, `no-answer`, or `canceled`.
Allowed:queuedringingin-progresscompletedbusyfailedno-answercanceled
StartTimestringoptional
Include calls that started on the specified UTC date in `YYYY-MM-DD` format.
StartTime<stringoptional
Include calls that started before the specified UTC date in `YYYY-MM-DD` format.
StartTime>stringoptional
Include calls that started on or after the specified UTC date in `YYYY-MM-DD` format.
EndTimestringoptional
Include calls that ended on the specified UTC date in `YYYY-MM-DD` format.
EndTime<stringoptional
Include calls that ended before the specified UTC date in `YYYY-MM-DD` format.
EndTime>stringoptional
Include calls that ended on or after the specified UTC date in `YYYY-MM-DD` format.
PageSizeintegeroptional
The number of calls per page. Must be between 1 and 1000 and defaults to 50 when omitted.
Pageintegeroptional
The page index for client state. Must be zero or greater.
PageTokenstringoptional
The pagination token provided by the API.

1 status code
200Returns a paginated collection of call resources, including pagination links, indexes, and call details.
endintegeroptional
first_page_uristringoptional
next_page_uristringoptional
pageintegeroptional
page_sizeintegeroptional
previous_page_uristringoptional
startintegeroptional
uristringoptional
callsarray<object>optional

Error handling

AccountSid must be a 34-character Account SID, and ParentCallSid must match a 34-character Call SID when supplied. Status must be one of queued, ringing, in-progress, completed, busy, failed, no-answer, or canceled; PageSize must be between 1 and 1000 and Page must be zero or greater.