Retrieves a collection of calls made to and from your account

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

Copy endpoint

https://api.twilio.com

Parameters

path Path Parameters

Name	Type
`AccountSid` required The SID of the Account that created the Call resource(s) to read.	`AC${string}`

query Query Parameters

Name	Type
`To` Only show calls made to this phone number, SIP address, Client identifier or SIM SID.	string
`From` Only include calls from this phone number, SIP address, Client identifier or SIM SID.	string
`ParentCallSid` Only include calls spawned by calls with this SID.	`CA${string}`
`Status` The status of the calls to include. Can be: `queued`, `ringing`, `in-progress`, `canceled`, `completed`, `failed`, `busy`, or `no-answer`.	type CallEnumStatus = "queued" \| "ringing" \| "in-progress" \| "completed" \| "busy" \| "failed" \| "no-answer" \| "canceled"
`StartTime` Only include calls that started on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only calls that started on this date. You can also specify an inequality, such as `StartTime<=YYYY-MM-DD`, to read calls that started on or before midnight of this date, and `StartTime>=YYYY-MM-DD` to read calls that started on or after midnight of this date.	string
`StartTime<` Only include calls that started on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only calls that started on this date. You can also specify an inequality, such as `StartTime<=YYYY-MM-DD`, to read calls that started on or before midnight of this date, and `StartTime>=YYYY-MM-DD` to read calls that started on or after midnight of this date.	string
`StartTime>` Only include calls that started on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only calls that started on this date. You can also specify an inequality, such as `StartTime<=YYYY-MM-DD`, to read calls that started on or before midnight of this date, and `StartTime>=YYYY-MM-DD` to read calls that started on or after midnight of this date.	string
`EndTime` Only include calls that ended on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only calls that ended on this date. You can also specify an inequality, such as `EndTime<=YYYY-MM-DD`, to read calls that ended on or before midnight of this date, and `EndTime>=YYYY-MM-DD` to read calls that ended on or after midnight of this date.	string
`EndTime<` Only include calls that ended on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only calls that ended on this date. You can also specify an inequality, such as `EndTime<=YYYY-MM-DD`, to read calls that ended on or before midnight of this date, and `EndTime>=YYYY-MM-DD` to read calls that ended on or after midnight of this date.	string
`EndTime>` Only include calls that ended on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only calls that ended on this date. You can also specify an inequality, such as `EndTime<=YYYY-MM-DD`, to read calls that ended on or before midnight of this date, and `EndTime>=YYYY-MM-DD` to read calls that ended on or after midnight of this date.	string
`PageSize` How many resources to return in each list page. The default is 50, and the maximum is 1000.	number
`Page` The page index. This value is simply for client state.	number
`PageToken` The page token. This is provided by the API.	string

Responses

200 application/json

{
calls?:

ApiV2010AccountCall

interface ApiV2010AccountCall {
sid?: `CA${string}` | null;
date_created?: string | null;
date_updated?: string | null;
parent_call_sid?: `CA${string}` | null;
account_sid?: `AC${string}` | null;
to?: string | null;
to_formatted?: string | null;
from?: string | null;
from_formatted?: string | null;
phone_number_sid?: `PN${string}` | null;
status?: CallEnumStatus;
start_time?: string | null;
end_time?: string | null;
duration?: string | null;
price?: string | null;
price_unit?: string | null;
direction?: string | null;
answered_by?: string | null;
api_version?: string | null;
forwarded_from?: string | null;
group_sid?: `GP${string}` | null;
caller_name?: string | null;
queue_time?: string | null;
trunk_sid?: `TK${string}` | null;
uri?: string | null;
subresource_uris?: {} | null;
}

[];
end?: number;
first_page_uri?: string;
next_page_uri?: string | null;
page?: number;
page_size?: number;
previous_page_uri?: string | null;
start?: number;
uri?: string;
}