List Notification Contacts

Returns the notification contacts for the authenticated login, including invalidation reason when an address was bounced or marked as spam.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Returns the notification contacts registered for the authenticated login.

Contacts are separate from the login email. Notifications are delivered to these addresses, not to the login email.

Response fields

FieldTypeDescription
iduuidContact ID.
typestringemail or phone.
valuestringEmail address or phone in international format.
invalid_atdatetime | nullWhen the contact was invalidated, or null.
invalid_reasonstring | nullbounce (permanent delivery failure) or complaint (marked as spam).

Example response (empty)

{ "contacts": [] }

Example response (with contacts)

{
  "contacts": [
    { "id": "{contact_id}", "type": "email", "value": "[email protected]",
      "invalid_at": null, "invalid_reason": null },
    { "id": "{contact_id}", "type": "phone", "value": "+5511999990000",
      "invalid_at": "2026-10-07T16:40:43.512Z", "invalid_reason": "bounce" }
  ]
}
📘

An invalidated contact stays in the list and occupies a slot. To resume receiving, delete it and register a new address.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json