# Retrieves a collection of calls made to and from your account

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

Retrieves a collection of calls made to and from your account
A Call is an object that represents a connection between a telephone and Twilio.

## Servers
- https://api.twilio.com: https://api.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **AccountSid** (string)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Call resource(s) to read.

### Query parameters
- **To** (string(phone-number))
  Only show calls made to this phone number, SIP address, Client identifier or SIM SID.
- **From** (string(phone-number))
  Only include calls from this phone number, SIP address, Client identifier or SIM SID.
- **ParentCallSid** (string)
  Only include calls spawned by calls with this SID.
- **Status** (string)
  The status of the calls to include. Can be: `queued`, `ringing`, `in-progress`, `canceled`, `completed`, `failed`, `busy`, or `no-answer`.
- **StartTime** (string(date-time))
  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.
- **StartTime<** (string(date-time))
  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.
- **StartTime>** (string(date-time))
  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.
- **EndTime** (string(date-time))
  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.
- **EndTime<** (string(date-time))
  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.
- **EndTime>** (string(date-time))
  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.
- **PageSize** (integer(int64))
  How many resources to return in each list page. The default is 50, and the maximum is 1000.
- **Page** (integer)
  The page index. This value is simply for client state.
- **PageToken** (string)
  The page token. This is provided by the API.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **calls** (array[object])

- **end** (integer)

- **first_page_uri** (string(uri))

- **next_page_uri** (string(uri) | null)

- **page** (integer)

- **page_size** (integer)

- **previous_page_uri** (string(uri) | null)

- **start** (integer)

- **uri** (string(uri))



[Powered by Bump.sh](https://bump.sh)