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

List notifications for a call

Lists notifications generated for a specific call. Use Log to filter by error or warning level, the message date parameters to filter by date, and the pagination parameters to control the result page.

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

9 parameters
AccountSidstringrequired
The account SID whose call notifications to retrieve. Must be a 34-character value matching the `AC` SID format.
CallSidstringrequired
The call SID whose notifications to retrieve. Must be a 34-character value matching the `CA` SID format.
Logintegeroptional
Filters notifications by log level: `0` for ERROR notifications or `1` for WARNING notifications. Returns all notification levels when omitted.
MessageDatestringoptional
Filters notifications by date in `YYYY-MM-DD` format and supports inequality expressions such as `<=YYYY-MM-DD` and `>=YYYY-MM-DD`.
MessageDate<stringoptional
Filters notifications by date in `YYYY-MM-DD` format using a less-than date condition.
MessageDate>stringoptional
Filters notifications by date in `YYYY-MM-DD` format using a greater-than date condition.
PageSizeintegeroptional
The number of notifications to return per page. Must be between 1 and 1000 and defaults to 50 when omitted.
Pageintegeroptional
The zero-based page index used to maintain client pagination state.
PageTokenstringoptional
The pagination token provided by the API for retrieving a specific page.

1 status code
200Returns a paginated notification response containing notification objects and page metadata with 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, and CallSid must be a 34-character call SID beginning with CA. Log accepts 0 for ERROR notifications or 1 for WARNING notifications, while each message-date value must use the YYYY-MM-DD format and PageSize must be between 1 and 1000.