Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/Notifications.json

List notifications

Lists notifications belonging to the account used for the request. Filter results by Log or message date, and use PageSize, Page, and PageToken to paginate the notification collection.

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

8 parameters
AccountSidstringrequired
The SID of the account whose notifications to list. Must be a 34-character SID matching the `AC` account identifier format.
Logintegeroptional
Filters notifications by log level: `0` for ERROR notifications or `1` for WARNING notifications. Returns all log levels when omitted.
MessageDatestringoptional
Filters notifications by date in `YYYY-MM-DD` format and can include an inequality such as `<=YYYY-MM-DD` or `>=YYYY-MM-DD`.
MessageDate<stringoptional
Filters notifications by date in `YYYY-MM-DD` format, including an optional less-than inequality.
MessageDate>stringoptional
Filters notifications by date in `YYYY-MM-DD` format, including an optional greater-than inequality.
PageSizeintegeroptional
The number of notifications to return per page. Must be between 1 and 1000 and defaults to 50 when omitted.
Pageintegeroptional
The page index used for client-side pagination state. Must be zero or greater.
PageTokenstringoptional
The pagination token provided by the API for retrieving a specific result page.

1 status code
200Returns a paginated notification collection with page boundaries, page links, page metadata, and notification objects containing error, request, response, and timestamp details.
endintegeroptional
first_page_uristringoptional
next_page_uristringoptional
pageintegeroptional
page_sizeintegeroptional
previous_page_uristringoptional
startintegeroptional
uristringoptional
notificationsarray<object>optional

Error handling

AccountSid must be a 34-character SID beginning with AC. Log must identify level 0 or 1 when supplied, date filters must use YYYY-MM-DD format, and PageSize must be between 1 and 1000.