---
title: "Recent delivery attempts for an endpoint"
method: GET
path: "/api/v1/webhooks/{endpointId}/deliveries"
tags: ["Public API v1"]
---

# Recent delivery attempts for an endpoint

`GET /api/v1/webhooks/{endpointId}/deliveries`

## Request

- Base URL: `https://api.vieneu.io`
- URL: `https://api.vieneu.io/api/v1/webhooks/{endpointId}/deliveries`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Self-diagnosis for a receiver that is not getting events. `status: DEAD` means we gave up and will not send that event again — fetch the result with `GET /v1/tts/{jobId}` instead.

We never record or return your endpoint's response body; `lastError` is a short code and `lastStatusCode` is the HTTP status we saw.

## Path parameters

- `endpointId` string, required

## Response `200`

The most recent delivery attempts, newest first.

- WebhookDeliveryResponseDto[]
  - `id` string, required
  - `eventId` string, required
  - `eventType` string, required
  - `status` 'PENDING' | 'DELIVERED' | 'DEAD', required: DEAD means we gave up; the event will not be sent again.
  - `attempts` number, required
  - `lastStatusCode` number, nullable
  - `lastError` string, nullable: Short failure code. We never record or return your endpoint's response body.
  - `lastDurationMs` number, nullable
  - `lastAttemptAt` string, date-time, nullable
  - `deliveredAt` string, date-time, nullable
  - `createdAt` string, date-time, required

## Other responses

- `404`: No such endpoint on this account.

## Changes

- **2026-09-16** `98838c7c0e72`: 1 info
  - added the optional property `retryAfterSeconds` to the response with the `404` status
- **2026-09-08** `633d63e717b8`: 2 breaking, 5 info
  - the response property `statusCode` became optional for the status `404`
  - response property `message` list-of-types was widened by adding types `array` to media type `application/json` of response `404`
  - added the optional property `code` to the response with the `404` status
  - added the optional property `error` to the response with the `404` status
  - …3 more
- **2026-09-05** `c9d346918371`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vieneu/apis/vieneu-api/changes/api/v1/webhooks/:endpointId/deliveries/get.md)

---

[API](https://skmtc.dev/vieneu/apis/vieneu-api.md) - [All operations](https://skmtc.dev/vieneu/apis/vieneu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vieneu/apis/vieneu-api/revisions/9518b716e16d?raw)