BitelioBitelio

List survey delivery history

Merchant server only, secret key with retention:view. Newest first, at most20 records, opaque nextCursor. Project-scoped limit120 requests/minute shared with survey channel API. ACCEPTED is not evidence of device delivery; UNKNOWN must not trigger a resend. This compatibility endpoint returns survey invitations only; use /v1/retention/messages for all message kinds.

GET
/v1/retention/survey-deliveries

Authorization

ApiKeyAuth

AuthorizationBearer <token>

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. The project is automatically derived from the key.

In: header

Query Parameters

after?string
Lengthlength <= 400

Response Body

application/json

curl -X GET "https://bitelio-api.heltia.com/v1/retention/survey-deliveries"
{
  "items": [
    {
      "id": "string",
      "channel": "EMAIL",
      "status": "QUEUED",
      "lastError": "string",
      "attempts": 0,
      "acceptedAt": "2019-08-24T14:15:22Z",
      "deliveredAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "openedAt": "2019-08-24T14:15:22Z",
      "clickedAt": "2019-08-24T14:15:22Z",
      "repliedAt": "2019-08-24T14:15:22Z",
      "kind": "SURVEY"
    }
  ],
  "nextCursor": "string"
}
Empty
Empty
Empty
Empty
Empty