---
title: "Retrieve a list of usage-records belonging to the account used to make the request"
method: GET
path: "/2010-04-01/Accounts/{AccountSid}/Usage/Records.json"
tags: ["Api20100401Record"]
---

# Retrieve a list of usage-records belonging to the account used to make the request

`GET /2010-04-01/Accounts/{AccountSid}/Usage/Records.json`

Retrieve a list of usage-records belonging to the account used to make the request

## Path parameters

- `AccountSid` string, required

## Query parameters

- `Category` string
- `StartDate` string, date
- `EndDate` string, date
- `IncludeSubaccounts` boolean
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `end` integer
  - `first_page_uri` string, uri
  - `next_page_uri` string, uri, nullable
  - `page` integer
  - `page_size` integer
  - `previous_page_uri` string, uri, nullable
  - `start` integer
  - `uri` string, uri
  - `usage_records` ApiV2010AccountUsageUsageRecord[]
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage.
    - `api_version` string, nullable — The API version used to create the resource.
    - `as_of` string, nullable — Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT
    - `category` string, nullable — The category of usage. For more information, see [Usage Categories](https://www.twilio.com/docs/usage/api/usage-record#usage-categories).
    - `count` string, nullable — The number of usage events, such as the number of calls.
    - `count_unit` string, nullable — The units in which `count` is measured, such as `calls` for calls or `messages` for SMS.
    - `description` string, nullable — A plain-language description of the usage category.
    - `end_date` string, date, nullable — The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`.
    - `price` number, nullable — The total price of the usage in the currency specified in `price_unit` and associated with the account.
    - `price_unit` string, currency, nullable — The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`.
    - `start_date` string, date, nullable — The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`.
    - `subresource_uris` object, nullable — A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources).
    - `uri` string, nullable — The URI of the resource, relative to `https://api.twilio.com`.
    - `usage` string, nullable — The amount used to bill usage and measured in units described in `usage_unit`.
    - `usage_unit` string, nullable — The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS.

---

[API](https://skmtc.net/twilio/apis/api-v2010.md) · [All operations](https://skmtc.net/twilio/apis/api-v2010/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/api-v2010/versions/a6753266b8b0/schema)