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

# Listaa toimitukset

> Listaa webhookin toimitusyritykset

Listaa yhden webhookin toimitukset uusin ensin, mukaan lukien jokainen yritys ja päätepisteesi
palauttama HTTP-tilakoodi.

> [!NOTE]
>
> Vaatii `webhooks_manage`-scopen.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Webhookin tunniste (UUID).

### Kyselyparametrit

**status** `string`

Vain tässä tilassa olevat toimitukset: `pending`, `succeeded`, `failed` tai `cancelled`.

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

Palautettavien toimitusten enimmäismäärä, 1–100.

**before** `string`

Tämän webhookin toimituksen tunniste. Anna sivun viimeinen `id` saadaksesi seuraavan sivun.

## Vastaus

Onnistuessaan API palauttaa `200 OK`.

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

Toimitukset, uusin ensin.

**toimitus**

**id** `string` *required*

Toimituksen tunniste (UUID). Yksi toimitus lähettää yhden tapahtuman yhteen webhookiin.

**event** `object` *required*

Tapahtuma täsmälleen sellaisena kuin se lähetettiin pyynnön rungossa. Katso [Sisältö](https://docs.anivahealth.com/fi/concepts/webhooks.md#tietosisaeltoe).

**status** `string` *required*

`pending`, `succeeded`, `failed` (kaikki yritykset epäonnistuivat tai päätepiste vastasi `410 Gone`) tai
`cancelled` (webhook poistettiin käytöstä toimituksen odottaessa).

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

Tähän mennessä tehdyt yritykset. Uudelleenlähetys alkaa taas luvusta `0`.

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

Seuraavan yrityksen ISO 8601 UTC -ajankohta. `null`, kun uutta yritystä ei ole suunniteltu.

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

Viimeisimmän yrityksen ISO 8601 UTC -ajankohta. Voi olla `null`.

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

Viimeisimmän yrityksen HTTP-tilakoodi. `null`, kun vastausta ei saatu, esimerkiksi aikakatkaisun vuoksi.

**last\_error** `string`

Verkkovirhe tai tilakoodi ja vastauksen rungon alkuosa. `null` onnistumisen jälkeen.

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

Viimeisimmät 20 yritystä vanhimmasta alkaen. Jokaisessa on `at`, `status` (HTTP-tilakoodi tai `null`),
`duration_ms` ja `error`.

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

ISO 8601 UTC -ajankohta, jolloin toimitus luotiin.

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

`true`, kun vanhempia toimituksia on olemassa. Hae ne antamalla viimeinen `id` `before`-parametrina.

## Virhevastaukset

| Tilakoodi | Kuvaus |
| - | - |
| `400` | Virheellinen pyyntö, tai `before` ei ole tämän webhookin toimitus. Katso `error`-viesti. |
| `401` | Virheellinen API-avain. |
| `403` | API-avain puuttuu tai sillä ei ole `webhooks_manage`-käyttöoikeutta. |
| `404` | Webhookia ei löytynyt, tai se kuuluu toiselle API-avaimelle. |
| `500` | Palvelimen sisäinen virhe. |

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