Outbound

List a user's Outbound deliveries

Returns every delivery of a message to one user, newest first. A delivery is one send of the message; a user can receive a recurring chat or banner several times.

GET

/v2/outbound/messages/{outboundMessageId}/analytics/users/{userId}/deliveries

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

{
  "data": [
    {
      "deliveryId": "f1f8a4c5-0d2e-5a1b-8c3d-9e4f5a6b7c8d",
      "firstEventAt": "2026-09-03T12:00:00.000Z",
      "lastEventAt": "2026-09-03T12:05:00.000Z"
    }
  ],
  "nextCursor": "<string>",
  "object": "list"
}

Query Parameters

limit - Number of deliveries to return (1-200, default 100)
cursor - Cursor from a previous response's nextCursor

Response

Each row has deliveryId, firstEventAt and lastEventAt. Use deliveryId with the delivery events endpoint to see the full journey.

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 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

userIdstringrequired

Required string length: 1 - 200

Query Parameters

limitintegerquerydefault:100

Required range: 1 <= x <= 200

cursorstringquery

Maximum string length: 500

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

Deliveries of this message to the user, newest first

Show child attributes

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