/status

Check the delivery status of a previously sent notification.

Endpoint

GET https://api.smooven.io/v1/status/{notification_id}

Request

curl https://api.smooven.io/v1/status/ntf_abc123def456 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Response

{
  "notification_id": "ntf_abc123def456",
  "status": "delivered",
  "channel_used": "sms",
  "channel_requested": "sms",
  "recipient": {
    "user_id": "sarah@example.com",
    "channel_address": "+61400000000"
  },
  "timestamps": {
    "created": "2026-03-05T08:00:00Z",
    "sent": "2026-03-05T08:00:01Z",
    "delivered": "2026-03-05T08:00:03Z"
  },
  "fallback_chain": []
}

Status values

Status	Description
queued	Notification accepted and waiting to be processed
sent	Handed off to the delivery provider
delivered	Confirmed delivery to the recipient
opened	Recipient opened the notification (email, push)
clicked	Recipient clicked a link or action
failed	Permanent delivery failure
undelivered	Could not reach recipient after all retry attempts

Fallback information

If Smart Routing triggered a fallback, the response includes the chain of attempted channels:

{
  "notification_id": "ntf_xyz789",
  "status": "delivered",
  "channel_used": "sms",
  "channel_requested": "rcs",
  "fallback_chain": [
    { "channel": "rcs", "status": "failed", "reason": "rcs_not_supported" },
    { "channel": "sms", "status": "delivered" }
  ]
}