Skip to content
Norbelys
Esc
↑↓navigate↵open⌘Jpreview

Retrieve a delivery event.

GET/v1/delivery_events/{id}
Authorization
AuthorizationBearer token · headerrequired

An API key (nb_live_…, nb_test_…), a workspace token (nbs_…) or a CLI token (nbc_…).

Path parameters
idId_DeliveryEventrequired

The delivery event id (dev_…).

matches ^dev_[0-9a-f]{32}$
Responses
200

The delivery event.

actionstring | null

The RFC 3464 action, for a delivery status notification.

attempt_numberinteger<int32> | null

The attempt it comes from, when its source is an attempt.

categorystringrequired
confidencestringrequired

authenticated, corroborated, inferred or human_text. New values may be added.

diagnosticstring | null
enhanced_statusstring | null
idId_DeliveryEventrequired
matches ^dev_[0-9a-f]{32}$
kindstringrequired

accepted, deferred, delivered, bounced, rejected, complaint, unsubscribed, address_changed or reported. New values may be added.

message_idId_Message | null
Show properties
One of:
Id_Message
string
null
null
observed_atTimestamprequired

When the source observed it.

phasestring | null
processed_atTimestamprequired

When Norbelys recorded it.

received_atTimestamprequired

When Norbelys received it.

recipientstring | null

The recipient it concerns; null when the evidence names none.

recipient_refstringrequired

Why the recipient is known: named, single_envelope or unknown. New values may be added.

sourcestringrequired

smtp, provider_api, provider_webhook, dsn, arf, inbound_notice, preflight, unsubscribe, manual or sent_folder. New values may be added.

thread_idId_Thread | null
Show properties
One of:
Id_Thread
string
null
null
401

No valid credential.

codestringrequired

The code from the closed registry; programs branch on it, never on the text. New codes may be added.

detailstringrequired

What went wrong, for a person; never an internal cause.

errorsFieldError[]

With validation_failed only: every invalid field.

Show properties
Array of FieldError
codestringrequired

What is wrong (required, range, length, format, invalid, …).

detailstringrequired

A safe, human-readable explanation.

pointerstringrequired

RFC 6901 pointer into the body, or ?name for a query parameter.

instancestringrequired

The request's path.

request_idstringrequired

The request's id, also in X-Request-Id: what support needs to find the request.

retry_afterinteger<int64> | null

With 429 and 503: the seconds to wait, as in Retry-After.

min 0
statusinteger<int32>required

The HTTP status.

min 0
titlestringrequired

Fixed per code.

typestringrequired

https://docs.norbelys.com/errors/<code>, a page that explains the code.

403

The credential lacks messages:read.

codestringrequired

The code from the closed registry; programs branch on it, never on the text. New codes may be added.

detailstringrequired

What went wrong, for a person; never an internal cause.

errorsFieldError[]

With validation_failed only: every invalid field.

Show properties
Array of FieldError
codestringrequired

What is wrong (required, range, length, format, invalid, …).

detailstringrequired

A safe, human-readable explanation.

pointerstringrequired

RFC 6901 pointer into the body, or ?name for a query parameter.

instancestringrequired

The request's path.

request_idstringrequired

The request's id, also in X-Request-Id: what support needs to find the request.

retry_afterinteger<int64> | null

With 429 and 503: the seconds to wait, as in Retry-After.

min 0
statusinteger<int32>required

The HTTP status.

min 0
titlestringrequired

Fixed per code.

typestringrequired

https://docs.norbelys.com/errors/<code>, a page that explains the code.

404

No such delivery event in this workspace (not_found), or its period was archived (archived): POST /v1/exports reads it.

codestringrequired

The code from the closed registry; programs branch on it, never on the text. New codes may be added.

detailstringrequired

What went wrong, for a person; never an internal cause.

errorsFieldError[]

With validation_failed only: every invalid field.

Show properties
Array of FieldError
codestringrequired

What is wrong (required, range, length, format, invalid, …).

detailstringrequired

A safe, human-readable explanation.

pointerstringrequired

RFC 6901 pointer into the body, or ?name for a query parameter.

instancestringrequired

The request's path.

request_idstringrequired

The request's id, also in X-Request-Id: what support needs to find the request.

retry_afterinteger<int64> | null

With 429 and 503: the seconds to wait, as in Retry-After.

min 0
statusinteger<int32>required

The HTTP status.

min 0
titlestringrequired

Fixed per code.

typestringrequired

https://docs.norbelys.com/errors/<code>, a page that explains the code.

Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.norbelys.com/v1/delivery_events/dev_0190f8a2b4c87a10b6d2e4f6a8c0e2f4' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "action": "string",
  "attempt_number": 0,
  "category": "string",
  "confidence": "string",
  "diagnostic": "string",
  "enhanced_status": "string",
  "id": "dev_0190f8a2b4c87a10b6d2e4f6a8c0e2f4",
  "kind": "string",
  "message_id": "msg_0190f8a2b4c87a10b6d2e4f6a8c0e2f4",
  "observed_at": "2019-08-24T14:15:22Z",
  "phase": "string",
  "processed_at": "2019-08-24T14:15:22Z",
  "received_at": "2019-08-24T14:15:22Z",
  "recipient": "string",
  "recipient_ref": "string",
  "source": "string",
  "thread_id": "thr_0190f8a2b4c87a10b6d2e4f6a8c0e2f4"
}