Get message

GET/api/v1/messages/{id}

A message and how it went: sent, delivered, bounced …

Guide: messages from Qrona →

Scope

messages:send Send messages – the person behind the key must be all members.

Path parameters

idstringrequired: The message's id.

Response

200 The message.

message_idstringrequired: The message's id.
statusstringrequired: queued: waiting for another attempt · sent: handed to the sending service · delivered: delivered · bounced: bounced · complained: spam complaint · failed: could not be delivered · suppressed: not sent, see reason.queuedsendingsentdeliveredbouncedcomplainedfailedsuppressed
reasonstring | nullrequired: Why a message was not sent: bounced, complained, manual, erased, unsubscribed (marketing only), service_limit, monthly_cap or payment.
templatestringrequired
template_versionintegerrequired: The template version the message was made from. Published versions never change.
html_sha256stringrequired: SHA-256 of the HTML the recipient got.
categorystringrequired: servicemarketing
referencestringrequired
client_refstringrequired
created_atstring (time, ISO 8601)required: When the message was received.

Errors

401: unauthenticated invalid_key key_revoked key_expired key_inactive
402: payment_required
403: insufficient_scope forbidden workspace_suspended
404: not_found
429: rate_limited
500: internal_error

Request

curl 'https://newsletter.qrona.se/api/v1/messages/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY"

Response 200

{
  "message_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "status": "sent",
  "reason": null,
  "template": "byra.momsunderlag",
  "template_version": 3,
  "html_sha256": "f3b1c2d4e5a6978812345678909abcdef0123456789abcdef0123456789abcde",
  "category": "service",
  "reference": "occ_20261023_0042",
  "client_ref": "kl_7f3a",
  "created_at": "2026-10-23T08:30:00.000Z"
}