List events for a message

GET

/v1/amb/messages/{message_id}/events

const result = await bird.amb.listEvents("amb_01krdgeqcxet5s7t44vh8rt9mg");
console.log(result);

result = client.amb.list_events('amb_01krdgeqcxet5s7t44vh8rt9mg')
print(result)

result, err := client.Amb.ListEvents(ctx, "amb_01krdgeqcxet5s7t44vh8rt9mg", bird.AmbListEventsParams{})
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

$bird->amb->listEvents('amb_01krdgeqcxet5s7t44vh8rt9mg');

bird amb list-events <message-id>

curl -X GET "https://us1.platform.bird.com/v1/amb/messages/{message_id}/events" \
  -H "Authorization: Bearer $TOKEN"

Risposta200

{
  "data": [
    {
      "id": "aev_01krdgeqcxet5s7t44vh8rt9mg",
      "type": "amb.sent",
      "error": {
        "code": "bird:business_not_registered",
        "description": "Apple refused the message with HTTP status 404."
      }
    }
  ]
}

Returns a message's lifecycle events in chronological order, one entry per status transition (amb.accepted, amb.sent, amb.send_failed, amb.received). The timeline is bounded and returned in full, so this list is not paginated. Event history does not expire based on age.

Parametri

message_id

string

Message identifier. Starts with amb_.

Parametri di query

type

string

Keep only events of this exact type (for example amb.sent or amb.send_failed). Omit for the full timeline.

Possible values (may grow over time): amb.accepted, amb.sent, amb.send_failed, amb.rejected, amb.received

Payload di risposta

data

array of object

obbligatorio

The message's events, oldest first. Not paginated: a message's timeline is bounded and returned in full.

Mostra attributi secondari

data.id

string

obbligatorio

ID of the event, unique within the message's timeline.

data.type

string

obbligatorio

Message timeline event type:

amb.accepted: The API accepted the request.
amb.sent: The message was handed to Apple.
amb.send_failed: Apple refused the message, or its send attempts were exhausted.
amb.rejected: Bird refused the message before any send attempt.
amb.received: An inbound message arrived from the customer.

This is an open enum. Accept unrecognized values.

Possible values (may grow over time): amb.accepted, amb.sent, amb.send_failed, amb.rejected, amb.received

data.occurred_at

string

obbligatorio

When this event occurred.

data.error

nullable object

Failure detail, on an amb.send_failed or amb.rejected event. Null on every other event type.

Mostra attributi secondari

data.error.code

string

obbligatorio

Machine-readable reason a send failed, in one of two namespaces: bird: for a reason Bird's own pipeline assigned (for example bird:business_not_registered), or apple: followed by the HTTP status Apple's API returned for the send attempt (for example apple:404). This is an open, growing set in both namespaces; accept unrecognized values.

data.error.description

string

obbligatorio

The failure in words. Free-form, so branch on code and show this to a human.

data.error.occurred_at

string

obbligatorio

When the failure occurred.

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Comprendi il concettoShould I use a Bird SDK or call the API directly?Segui il percorso di apprendimentoBuild your first integration Guida all'implementazioneSend your first email

Ottieni un brief di implementazione

const result = await bird.amb.listEvents("amb_01krdgeqcxet5s7t44vh8rt9mg");
console.log(result);

result = client.amb.list_events('amb_01krdgeqcxet5s7t44vh8rt9mg')
print(result)

result, err := client.Amb.ListEvents(ctx, "amb_01krdgeqcxet5s7t44vh8rt9mg", bird.AmbListEventsParams{})
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

$bird->amb->listEvents('amb_01krdgeqcxet5s7t44vh8rt9mg');

bird amb list-events <message-id>

curl -X GET "https://us1.platform.bird.com/v1/amb/messages/{message_id}/events" \
  -H "Authorization: Bearer $TOKEN"

Risposta200

{
  "data": [
    {
      "id": "aev_01krdgeqcxet5s7t44vh8rt9mg",
      "type": "amb.sent",
      "error": {
        "code": "bird:business_not_registered",
        "description": "Apple refused the message with HTTP status 404."
      }
    }
  ]
}