Retrieve an outbound messageMenu

Retrieve an outbound message

GET/v1/messages/{id}

Requires an API key with the messages:read scope. About keys and scopes

Works with integration, agent and partner keys.

Returns any outbound message in the message log, whatever its source and status, as the log lists it.

Path parameters

idstringrequired

The message's id.

uuid

Header parameters

Kirora-Workspacestringoptional

Partner keys only: the child workspace to act in, by the external id the partner gave it. Without it, a partner key acts in its own workspace. Any other key that sends it is refused with 403, and an unknown workspace is 404.

pattern ^[A-Za-z0-9._:-]{1,128}$

Returns

Returns 200 OK with an OutboundMessage in data. Otherwise returns an error; Errors lists every code and which to retry.

idstringrequired

uuid

messageTypestringrequired

marketing (from campaign or journey) or transactional (neither).

one of marketing, transactional

channelstringrequired

one of email, push

statusstringrequired

one of queued, sending, skipped, sent, failed, delivered, bounced, complained

campaignobject | nullrequired

The campaign it came from; null for any other message.

2 child attributes

idstringrequired: uuid
namestringrequired: The campaign's current name.

journeyobject | nullrequired

The journey it came from, deleted or not; null for any other message.

5 child attributes

idstring | nullrequired

Null once the journey is deleted.

uuid

namestring | nullrequired

The journey's current name; null once it is deleted.

deletedbooleanrequired

The journey was deleted after sending this. Its messages and their counts stay; nothing names the journey any more.

enrollmentIdstringrequired

The enrollment that sent it.

uuid

stepIdstringrequired

The id of the step that sent it.

templateobject | nullrequired

The stored template and published version it was sent from; null for inline content.

2 child attributes

idstringrequired: uuid
versionintegerrequired: min > 0

copyobject | nullrequired

Set on a cc or bcc copy; null on the message itself.

2 child attributes

kindstringrequired

one of cc, bcc

ofstringrequired

The message it is a copy of.

uuid

contactobject | nullrequired

Who it was for; null when the contact was deleted, or the message passed the retention period: it no longer names anyone.

5 child attributes

idstringrequired: uuid
externalIdstring | nullrequired
emailstring | nullrequired: The contact's email now, which may differ from recipientEmail.
firstNamestring | nullrequired: The contact's first name now.
lastNamestring | nullrequired: The contact's last name now.

recipientEmailstring | nullrequired

The email address the message went to, frozen at the first attempt; null until then, and for push.

simulatedbooleanrequired

Sent to a reserved test address (example.com and the like): it passed every check a real send does but was never handed to the provider. Any outcome was simulated from the address, as [email protected] simulates a bounce.

correlationIdstring | nullrequired

The reference a transactional send carried; null otherwise.

sendAtstring | nullrequired

When a timed transactional send is due; null for one sent at once.

date-time

sentAtstring | nullrequired

When it was handed to the provider.

date-time

deliveredAtstring | nullrequired

When the provider confirmed delivery.

date-time

openedAtstring | nullrequired

First open, when tracked: a person's first open or click, or a machine's open while only a machine has opened it.

date-time

openedByMachinebooleanrequired

Only a machine has opened it so far: a mail app fetched its images with no reader (Apple Mail Privacy Protection, Gmail's prefetch on delivery) or a mail security scanner checked it. A click or a later open by a person clears it.

clickedAtstring | nullrequired

A person's first click, when tracked.

date-time

clickedByMachinebooleanrequired

A machine followed one of its links: a mail security scanner checking it on delivery, a link preview. Such a click sets no clickedAt and sends no webhook.

complainedAtstring | nullrequired

When the recipient marked it as spam (the first complaint); null for a simulated one.

date-time

bounceobject | nullrequired

The hard bounce: set when status is bounced; null otherwise. A soft bounce is a failure with reason transient_bounce.

3 child attributes

occurredAtstringrequired

When it happened.

date-time

typestringrequired

Why: mailbox_not_found, mailbox_full, suppressed (the provider refuses the address), or general for any other reason.

one of mailbox_not_found, mailbox_full, suppressed, general

detailstring | nullrequired

The receiving server's reply, such as smtp; 550 5.1.1 user unknown; null for a simulated bounce.

failureobject | nullrequired

Set when status is failed; null otherwise.

2 child attributes

occurredAtstringrequired

When it happened.

date-time

reasonstringrequired

Why sending broke, such as provider_rejected (the provider refused the content) or transient_bounce. not_sent: a problem on Kirora's side stopped it; nothing in your content, audience or setup caused it, and Kirora is alerted. In rare cases the provider may have delivered it before the problem.

skipobject | nullrequired

Set when status is skipped; null otherwise.

3 child attributes

occurredAtstringrequired

When it happened.

date-time

reasonstringrequired

Which guard stopped it before sending, such as suppressed, consent_missing or cancelled; fallback_not_needed: a transactional fallbackOrder fallback whose first channel arrived; plan_limit_reached: a fallback the plan had no room for when it was due; sending_review_required: email from a sending domain Kirora has not approved yet.

suppressionReasonstring | nullrequired

With suppressed: why the address is blocked: unsubscribed, bounced, complained, complained_transactional, manual or imported. Null otherwise.

one of manual, imported, unsubscribed, bounced, complained, complained_transactional

createdAtstringrequired

date-time

curl https://api.kirora.io/v1/messages/018f2a4e-6b1c-7d3e-9f40-37386ae05a6b \
  -H "Authorization: Bearer $KIRORA_API_KEY"

const response = await fetch('https://api.kirora.io/v1/messages/018f2a4e-6b1c-7d3e-9f40-37386ae05a6b', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.KIRORA_API_KEY}`,
  },
});
if (!response.ok) throw new Error(`Kirora API ${response.status}: ${await response.text()}`);
const { data } = await response.json();

import os

import requests

response = requests.get(
    "https://api.kirora.io/v1/messages/018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
    headers={
        "Authorization": f"Bearer {os.environ['KIRORA_API_KEY']}",
    },
)
response.raise_for_status()
data = response.json()["data"]

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.kirora.io/v1/messages/018f2a4e-6b1c-7d3e-9f40-37386ae05a6b", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("KIRORA_API_KEY"))

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode >= 300 {
		msg, _ := io.ReadAll(res.Body)
		panic(fmt.Sprintf("Kirora API %d: %s", res.StatusCode, msg))
	}

	var out struct {
		Data json.RawMessage `json:"data"`
	}
	if err := json.NewDecoder(res.Body).Decode(&out); err != nil {
		panic(err)
	}
}

using System.Net.Http.Headers;
using System.Text.Json;

using var http = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.kirora.io/v1/messages/018f2a4e-6b1c-7d3e-9f40-37386ae05a6b");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("KIRORA_API_KEY"));

using var response = await http.SendAsync(request);
if (!response.IsSuccessStatusCode)
    throw new HttpRequestException($"Kirora API {(int)response.StatusCode}: {await response.Content.ReadAsStringAsync()}");

using var document = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
var data = document.RootElement.GetProperty("data");

Response · 200

{
  "data": {
    "id": "0192f3b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
    "messageType": "marketing",
    "channel": "email",
    "status": "delivered",
    "campaign": {
      "id": "0192f3d3-5e6f-7071-8c83-9e0f1a2b3c4d",
      "name": "October newsletter"
    },
    "journey": null,
    "template": null,
    "copy": null,
    "contact": {
      "id": "0192f3a1-7c2e-7d4b-9a10-3e5f6a7b8c9d",
      "externalId": "customer-4821",
      "email": "[email protected]",
      "firstName": "Amaka",
      "lastName": "Obi"
    },
    "recipientEmail": "[email protected]",
    "simulated": false,
    "correlationId": null,
    "sendAt": null,
    "sentAt": "2026-10-01T09:31:00.000Z",
    "deliveredAt": "2026-10-01T09:31:04.000Z",
    "openedAt": "2026-10-01T10:02:00.000Z",
    "openedByMachine": false,
    "clickedAt": null,
    "clickedByMachine": false,
    "complainedAt": null,
    "bounce": null,
    "failure": null,
    "skip": null,
    "createdAt": "2026-10-01T09:30:58.000Z"
  }
}