---
title: "The per-attempt delivery log"
method: GET
path: "/v1/webhook-deliveries"
tags: ["Webhooks"]
---

# The per-attempt delivery log

`GET /v1/webhook-deliveries`

## Request

- Base URL: `https://carbonguru.io`
- URL: `https://carbonguru.io/v1/webhook-deliveries`
- Auth: HTTP bearer

One row per attempt with its status code, its error and when the next attempt is due. Cursor-paged; next_cursor is opaque and the Link header carries the same cursor as rel="next".

## Query parameters

- `endpoint_id` string
- `status` string
- `cursor` string
- `limit` integer

## Response `200`

A page of delivery attempts.

- object
  - `deliveries` WebhookDelivery[], required
    - `id` string
    - `endpoint_id` string
    - `event_id` string: The event this delivery carries. Retries of one event share it.
    - `event_type` string
    - `status` string: pending, delivered or failed.
    - `attempt_count` integer, nullable
    - `last_status_code` integer, nullable: The HTTP status the endpoint answered with.
    - `last_error` string, nullable
    - `created_at` string, nullable
    - `delivered_at` string, nullable
    - `next_attempt_at` string, nullable: Null when no further attempt is due.
  - `next_cursor` string, nullable, required

## Other responses

- `401`: No valid credential. Every authentication failure returns this one document.
- `403`: A missing scope, an exhausted analysis allowance, or an object that is not the caller's.
- `422`: The request's fields are wrong. errors[] names them.

---

[API](https://skmtc.dev/carbonguru/apis/carbonguru-api.md) · [All operations](https://skmtc.dev/carbonguru/apis/carbonguru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonguru/apis/carbonguru-api/revisions/26dcbe7a8500?raw)