/v1/workspaces/{workspace_id}/deliveries/{delivery_id}AuthGet a delivery
With every provider attempt (status, code, duration; no message content).
Path parameters
workspace_id*string · uuidId of the workspace.
delivery_id*string · uuidThe delivery id.
Response · 200 The delivery.
id*string · uuidThe delivery id.
notification_id*string · uuidThe notification.
recipient_id*string · uuidThe recipient id.
recipient_external_id*stringThe recipient external id (null after an erasure).
channel*objectThe channel.
provider*string`inbox`, `mail`, `apns`, `fcm` or `webpush`.
device_id*string · uuidThe device, for push and web push.
target*string`inbox`, `email:<address hash>` or `device:<id>`; `email:erased:<delivery id>` once the recipient was erased.
fallback_step*integer0 for an `always` channel; n for the n-th fallback step.
is_fallback*booleanPlanned because an earlier step failed.
state*objectThe state.
reason*objectWhy it was skipped, held, retried or failed (`mail_refused:<code>` carries Mail's code).
explanation*stringWhat the reason means and how to fix it.
attempts*integerProvider calls made.
next_attempt_at*string · date-timeNext try (retry, scheduled).
provider_message_id*stringProvider message id (APNs `apns-id`, FCM message name, Mail message id).
provider_unique_id*stringAPNs `apns-unique-id` (sandbox only).
rendered*objectThe push or web push title and body as sent (kept 30 days).
warnings*arrayRender warnings: `template_variable_missing:<name>`, `unsafe_url:<field>`.
sent_at*string · date-timeHanded to the provider (or written to the inbox).
final_at*string · date-timeReached its final state.
created_at*string · date-timePlanned.
attempts_log*arrayProvider calls, oldest first (no PII, no provider bodies).
Example
Request
GET https://api.notify.productcraft.co/v1/workspaces/{workspace_id}/deliveries/{delivery_id}
Authorization: Bearer YOUR_TOKENResponse
{
"id": "00000000-0000-0000-0000-000000000000",
"notification_id": "00000000-0000-0000-0000-000000000000",
"recipient_id": "00000000-0000-0000-0000-000000000000",
"recipient_external_id": "string",
"channel": {},
"provider": "string",
"device_id": "00000000-0000-0000-0000-000000000000",
"target": "string",
"fallback_step": 0,
"is_fallback": false,
"state": {},
"reason": {},
"explanation": "string",
"attempts": 0,
"next_attempt_at": "2026-01-01T00:00:00.000Z",
"provider_message_id": "string",
"provider_unique_id": "string",
"rendered": {},
"warnings": [
"string"
],
"sent_at": "2026-01-01T00:00:00.000Z",
"final_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"attempts_log": [
{
"attempt": 0,
"outcome": "string",
"provider_status": 0,
"provider_code": "string",
"retry_after_s": 0,
"duration_ms": 0,
"created_at": "2026-01-01T00:00:00.000Z"
}
]
}