API reference / Admin

get/v1/admin/notifications

Messages that did not land

Operation
adminListNotifications
Authentication
API key

Everything not `sent`, newest first: `failed` (the retry worker will try again), `abandoned` (it will not — see `error_message`) and `skipped` (never attempted, and why: no consent, no transport, no approved WhatsApp template). Account mail has no application and is included with a null reference, because those are the messages nobody can trace back to a record.

Request

Parameters

statusquerystring
channelquerystring
searchquerystring
limitqueryinteger
offsetqueryintegernull

Responses

200The undelivered messages and the total matching the filter.
messagesobject[]required
totalintegerrequired
limitintegerrequired
offsetintegerrequired
400The request body or query failed validation.
errorobjectrequired
401No key, an unknown key, a revoked key, or a key whose tenant is not active. All four return an identical body on purpose: distinguishing them would let a caller discover which partners we have.
errorobjectrequired
403`projects:write` is required. No partner key is ever issued this scope.
errorobjectrequired
404Not found, or not yours. A resource belonging to another tenant answers 404 rather than 403, because 403 would confirm the record exists.
errorobjectrequired

Example

curl
curl -X GET https://api.haavisa.com/v1/admin/notifications \
  -H "Authorization: Bearer $HAAVISA_API_KEY"

More in Admin

Something unclear? The eligibility guide explains the model behind the answers; the errors guide covers the envelope.