Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/Usage/Records/ThisMonth.json

List today's usage records

Lists usage records for the current day belonging to the account identified by AccountSid. Use Category, StartDate, and EndDate to filter the records, and IncludeSubaccounts to include usage from the master account and its subaccounts. Use Page, PageSize, and PageToken to navigate the paginated results.

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

8 parameters
AccountSidstringrequired
The account SID whose current-day usage records you want to retrieve. The value must be 34 characters and match the `AC` followed by 32 hexadecimal characters pattern.
Categorystringoptional
The usage category used to filter the returned usage records.
StartDatestringoptional
The GMT date from which to include usage, in `YYYY-MM-DD` format, or a relative expression such as `-30days`.
EndDatestringoptional
The GMT date through which to include usage, in `YYYY-MM-DD` format, or a relative expression such as `+30days`.
IncludeSubaccountsbooleanoptional
Whether to include usage from the account and all its subaccounts. Defaults to true when omitted.
PageSizeintegeroptional
The number of usage records to return per page. Defaults to 50 when omitted and must be between 1 and 1000.
Pageintegeroptional
The zero-based page index used for client state. Must be zero or greater.
PageTokenstringoptional
The pagination token provided by the API for retrieving a specific results page.

1 status code
200Returns a paginated object containing today's usage records and page metadata, including the page range, page size, navigation URIs, and usage record collection.
endintegeroptional
first_page_uristringoptional
next_page_uristringoptional
pageintegeroptional
page_sizeintegeroptional
previous_page_uristringoptional
startintegeroptional
uristringoptional
usage_recordsarray<object>optional

Error handling

AccountSid must be a 34-character account SID matching the AC prefix pattern. StartDate and EndDate must use the YYYY-MM-DD format or the documented relative-date expressions, and PageSize must be between 1 and 1000. Page must be zero or greater, and IncludeSubaccounts must be a boolean when provided.