> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Список доставок

> Получить список попыток доставки вебхука

Возвращает список доставок одного вебхука от новых к старым, включая каждую попытку и HTTP-статус,
которым ответил твой эндпоинт.

> [!NOTE]
>
> Требуется scope `webhooks_manage`.

## Запрос

### Параметры пути

**id** `string` *required*

Идентификатор вебхука (UUID).

### Параметры запроса

**status** `string`

Только доставки с этим статусом: `pending`, `succeeded`, `failed` или `cancelled`.

**limit** `integer` (default: 20)

Максимальное количество возвращаемых доставок — от 1 до 100.

**before** `string`

Идентификатор доставки этого вебхука. Передай последний `id` страницы, чтобы получить следующую.

## Ответ

При успехе API возвращает `200 OK`.

**data** `object[]` *required*

Доставки, от новых к старым.

**доставка**

**id** `string` *required*

Идентификатор доставки (UUID). Одна доставка отправляет одно событие на один вебхук.

**event** `object` *required*

Событие ровно в том виде, в котором оно отправлено в теле запроса. См. [Полезная нагрузка](https://docs.anivahealth.com/ru/concepts/webhooks.md#poleznaya-nagruzka).

**status** `string` *required*

`pending`, `succeeded`, `failed` (все попытки не удались или эндпоинт ответил `410 Gone`) или
`cancelled` (вебхук отключили, пока доставка ожидала отправки).

**attempt\_count** `integer` *required*

Количество выполненных попыток. При повторной отправке отсчёт снова начинается с `0`.

**next\_attempt\_at** `string`

Время следующей попытки в формате ISO 8601 (UTC). `null`, если попытка не запланирована.

**last\_attempt\_at** `string`

Время последней попытки в формате ISO 8601 (UTC). Может быть `null`.

**last\_response\_status** `integer`

HTTP-статус последней попытки. `null`, если ответ не пришёл, например из-за таймаута.

**last\_error** `string`

Сетевая ошибка либо статус и начало тела ответа. `null` после успешной доставки.

**attempts** `object[]` *required*

Последние 20 попыток, сначала самые старые. В каждой есть `at`, `status` (HTTP-статус или `null`),
`duration_ms` и `error`.

**created\_at** `string` *required*

Время создания доставки в формате ISO 8601 (UTC).

**has\_more** `boolean` *required*

`true`, если есть более старые доставки. Передай последний `id` в параметре `before`, чтобы получить их.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Некорректный запрос или `before` не относится к доставкам этого вебхука. См. сообщение `error`. |
| `401` | Неверный API-ключ. |
| `403` | API-ключ не передан или у него нет права доступа `webhooks_manage`. |
| `404` | Вебхук не найден или принадлежит другому API-ключу. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/webhooks/4a6c8e0f-2b4d-4f6a-8c0e-2a4c6e8f0b1d/deliveries \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "7c9e1a3b-5d7f-4b2d-9e4a-6c8e0a2b4d6f",
      "event": {
        "id": "0b8e6f3a-2c4d-4e7f-9a1b-3c5d7e9f1a2b",
        "type": "appointment.confirmed",
        "timestamp": "2026-10-15T09:12:44.512Z",
        "data": {
          "object": "appointment",
          "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
          "url": "https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
          "status": "confirmed",
          "previous_status": "pending",
          "status_revision": 2
        }
      },
      "status": "succeeded",
      "attempt_count": 2,
      "next_attempt_at": null,
      "last_attempt_at": "2026-10-15T09:13:06.000Z",
      "last_response_status": 204,
      "last_error": null,
      "attempts": [
        {
          "at": "2026-10-15T09:13:01.000Z",
          "status": 503,
          "duration_ms": 412,
          "error": "HTTP 503: Service Unavailable"
        },
        {
          "at": "2026-10-15T09:13:06.000Z",
          "status": 204,
          "duration_ms": 88,
          "error": null
        }
      ],
      "created_at": "2026-10-15T09:13:00.000Z"
    }
  ],
  "has_more": false
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.