Fetch multiple call resources

GET 
/texml/Accounts/:account_sid/Calls

Returns multiple call resouces for an account. This endpoint is eventually consistent.

Path Parameters

account_sid stringrequired

The id of the account the resource belongs to.

Query Parameters

Page integer
The number of the page to be displayed, zero-indexed, should be used in conjuction with PageToken.
Example: 1
PageSize integer
The number of records to be displayed on a page
Example: 10
PageToken string

Used to request the next page of results.

To string
Filters calls by the to number.
Example: +1312345678
From string
Filters calls by the from number.
Example: +1312345678
Status string
Possible values: [canceled, completed, failed, busy, no-answer]
Filters calls by status.
Example: no-answer
StartTime string
Filters calls by their start date. Expected format is YYYY-MM-DD.
Example: 2023-05-22
StartTime> string
Filters calls by their start date (after). Expected format is YYYY-MM-DD
Example: 2023-05-22
StartTime< string
Filters calls by their start date (before). Expected format is YYYY-MM-DD
Example: 2023-05-22
EndTime string
Filters calls by their end date. Expected format is YYYY-MM-DD
Example: 2023-05-22
EndTime> string
Filters calls by their end date (after). Expected format is YYYY-MM-DD
Example: 2023-05-22
EndTime< string
Filters calls by their end date (before). Expected format is YYYY-MM-DD
Example: 2023-05-22

200: Multiple call resources.

application/json

• Schema
• Example (from schema)

Schema

calls

object[]

Array [

account_sid string

The id of the account the resource belongs to.

answered_by string

Possible values: [human, machine, not_sure]

The value of the answering machine detection result, if this feature was enabled for the call.

caller_name string

Caller ID, if present.

date_created string

The timestamp of when the resource was created.

date_updated string

The timestamp of when the resource was last updated.

direction string

Possible values: [inbound, outbound]

The direction of this call.

duration string

The duration of this call, given in seconds.

end_time string

The end time of this call.

from string

The phone number or SIP address that made this call.

from_formatted string

The from number formatted for display.

price string

The price of this call, the currency is specified in the price_unit field. Only populated when the call cost feature is enabled for the account.

price_unit string

The unit in which the price is given.

sid string

The identifier of this call.

start_time string

The start time of this call.

status string

Possible values: [ringing, in-progress, canceled, completed, failed, busy, no-answer]

The status of this call.

to string

The phone number or SIP address that received this call.

to_formatted string

The to number formatted for display.

uri string

The relative URI for this call.

]

end integer

The number of the last element on the page, zero-indexed.

first_page_uri string

/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1

next_page_uri string

/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=1&PageSize=1&PageToken=MTY4AjgyNDkwNzIxMQ

page integer

Current page number, zero-indexed.

page_size integer

The number of items on the page

start integer

The number of the first element on the page, zero-indexed.

uri string

The URI of the current page.

{
  "calls": [],
  "end": 0,
  "first_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1",
  "next_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=1&PageSize=1&PageToken=MTY4AjgyNDkwNzIxMQ",
  "page": 0,
  "page_size": 1,
  "start": 0,
  "uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1"
}

404: Resource not found

application/json

• Schema
• Example (from schema)

Schema

errors

object[]

Array [

detail string

]

{
  "errors": [
    {
      "detail": "Resource not found"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/texml/Accounts/:account_sid/Calls' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• 404

---

{
  "calls": [],
  "end": 0,
  "first_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1",
  "next_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=1&PageSize=1&PageToken=MTY4AjgyNDkwNzIxMQ",
  "page": 0,
  "page_size": 1,
  "start": 0,
  "uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1"
}

{
  "errors": [
    {
      "detail": "Resource not found"
    }
  ]
}