# Claim prepared surveys for a mobile backend (/es/api-reference/survey-channels/claimMobileSurveyDeliveries)

`POST /v1/retention/survey-deliveries/claim`

Base URL: `https://api.bitelio.com`

Requires retention:view, retention:edit and retention:activate. Mobile API must be enabled. Claims up to20 current programme invitations after current programme, withdrawal, actor and subsequent-purchase checks. Each invitation is handed off once. Deliver before claimExpiresAt and report an actual result; do not send an expired claim. The merchant must verify its native notification consent and use its own APNs/FCM provider. Store capability and receipt tokens securely; never put an sk_ key in the mobile app. Limit120 requests/minute shared perproject. Only survey invitations are returned. Use /v1/retention/messages/claim to handle other retention messages.

## Request body

- `after`: string

Example:

```json
{
  "after": "string"
}
```

## Responses

### `200` — Success

- `items`: array<object> (required)
  items:
    - `deliveryId`: string (required)
    - `receiptToken`: string (required)
    - `surveyUrl`: string (required)
    - `surveyToken`: string (required)
    - `contactId`: string (required)
    - `locale`: string (required)
    - `title`: string (required)
    - `body`: string (required)
    - `expiresAt`: string (date-time) (required)
    - `claimExpiresAt`: string (date-time) (required)

```json
{
  "items": [
    {
      "deliveryId": "string",
      "receiptToken": "string",
      "surveyUrl": "string",
      "surveyToken": "string",
      "contactId": "string",
      "locale": "string",
      "title": "string",
      "body": "string",
      "expiresAt": "2026-10-24T08:42:45.049Z",
      "claimExpiresAt": "2026-10-24T08:42:45.049Z"
    }
  ]
}
```

### `400` — Invalid input or unavailable channel

### `401` — Secret API key required

### `403` — Required project permission is missing

### `429` — Project rate limit exceeded. Retry-After identifies the wait in seconds.

### `503` — Rate limiter temporarily unavailable; retry later.

## Example request

```bash
curl -X POST 'https://api.bitelio.com/v1/retention/survey-deliveries/claim' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"after":"string"}'
```