Outbound

List events for an Outbound delivery

Returns the event journey of one delivery in chronological order: sent, opened, clicked, replied, dismissed and so on.

GET

/v2/outbound/messages/{outboundMessageId}/analytics/deliveries/{deliveryId}/events

curl --request GET \
  --url 'https://do.featurebase.app/v2/outbound/messages/{outboundMessageId}/analytics/deliveries/{deliveryId}/events?limit=100&cursor=%3Cstring%3E&userId=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-09-03.pulsar'

{
  "data": [
    {
      "event": "sent",
      "eventAt": "2026-09-03T12:00:00.000Z",
      "eventId": "2b5f2d5e-4c8c-5f0e-9b4f-3a6c0b7f1d21",
      "metadata": {}
    }
  ],
  "deliveryId": "f1f8a4c5-0d2e-5a1b-8c3d-9e4f5a6b7c8d",
  "nextCursor": "<string>",
  "object": "list"
}

Query Parameters

userId - The recipient the delivery belongs to (required)
limit - Number of events to return (1-200, default 100)
cursor - Cursor from a previous response's nextCursor

Response

Each row has eventId, event, eventAt and event-specific metadata such as the clicked URL.

Permissions

This endpoint returns recipient identity data. The API key owner needs both the manage_outbound and the view_users permission. MCP Writer connectors cannot call it; use a Reader or Combined connector.

Errors

400 - Invalid message ID, delivery ID or cursor
403 - Missing the view_users permission
404 - Message not found or doesn't belong to your organization
502 / 504 - The analytics store failed or timed out

Version Availability

This endpoint is only available in API version 2026-09-03.pulsar and newer.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

outboundMessageIdstringrequired

Outbound message ID

Example: 6457e3ff70afca5d8c27dccc

deliveryIdstringrequired

Query Parameters

limitintegerquerydefault:100

Required range: 1 <= x <= 200

cursorstringquery

Maximum string length: 500

userIdstringqueryrequired

Required string length: 1 - 200

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-09-03.pulsar, 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-09-03.pulsar

Response

Success

dataobject[]required

Events of the delivery in chronological order

Show child attributes

deliveryIdstringrequired

Delivery ID

Example: f1f8a4c5-0d2e-5a1b-8c3d-9e4f5a6b7c8d

nextCursorstring | nullrequired

Cursor for the next page, or null when there are no more results

Maximum string length: 512

objectenum<string>required

Object type identifier

Available options: list

Example: list

Still need help? Ask the team