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

List notifications

Lists notifications belonging to an account. Filter results by log level or message date, and use the paging parameters to navigate the results. The response contains notification records and page metadata.

8 parameters
AccountSidstringrequired
The SID of the account whose notifications to list. It must be a 34-character account SID beginning with `AC`.
Logintegeroptional
Filter by notification log level: `0` for ERROR or `1` for WARNING. Defaults to all notifications when omitted.
MessageDatestringoptional
Filter notifications by date in `YYYY-MM-DD` format; an inequality such as `<=YYYY-MM-DD` or `>=YYYY-MM-DD` can specify a date boundary.
MessageDate<stringoptional
Filter notifications by date in `YYYY-MM-DD` format, including an inequality such as `<=YYYY-MM-DD` to select messages logged at or before the specified date.
MessageDate>stringoptional
Filter notifications by date in `YYYY-MM-DD` format, including an inequality such as `>=YYYY-MM-DD` to select messages logged at or after the specified date.
PageSizeintegeroptional
Number of resources to return on each page. Must be between 1 and 1000. Defaults to 50 when omitted.
Pageintegeroptional
Page index for client state. Must be a non-negative integer.
PageTokenstringoptional
Page token provided by the API to retrieve a particular page.

1 status code
200Returns a paginated response containing notification records and page metadata, including the page size and navigation URIs.
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 account SID beginning with AC. Log, if provided, must be 0 for ERROR notifications or 1 for WARNING notifications; date filters must use the YYYY-MM-DD format.