Skip to main content

Webhook Deliveries

1 operation under /v1/webhook-deliveries (GET): parameters, status codes, refusal bodies, and the same request in curl, HTTP, Python and TypeScript.

1 min read
View MarkdownEdit on GitHub

Base URL: https://api.codespar.dev

Every operation below requires a Bearer token. See Authentication.

GET /v1/webhook-deliveries

GEThttps://api.codespar.dev/v1/webhook-deliveries

List the project's webhook deliveries, across endpoints

Every delivery attempt of every webhook endpoint in the caller's project, newest first by delivery id, with the endpoint's name and the event type. Page with before set to the previous page's next_before; next_before is null on the last page. since keeps the attempts created at or after that instant, status one dispatcher status. With count_only=true the answer is total, the number of attempts matching since and status, and no rows. Unlike the per-endpoint listing, out-of-range or malformed parameters are refused, not clamped. Requires triggers:read.

Query parameters

NameTypeRequiredDescription
beforestringno—
count_only"true" | "false"no—
limitintegerno—
sincestring (date-time)no—
status"pending" | "delivered" | "failed" | "dead"no—

Responses

StatusBodyDescription
200objectOK
400objectThe query did not match the schema. details.issues carries the Zod issues.

Response 200

FieldTypeRequiredDescription
deliveriesarray of objectyes—
next_beforestring,nullyes—
totalintegernoOnly with count_only=true: how many deliveries match since and status. No rows come with it.
Example request
curl -X GET https://api.codespar.dev/v1/webhook-deliveries \
  -H "Authorization: Bearer $CODESPAR_API_KEY"
GET /v1/webhook-deliveries HTTP/1.1
Host: api.codespar.dev
Authorization: Bearer $CODESPAR_API_KEY
import os
import requests

res = requests.get(
    "https://api.codespar.dev/v1/webhook-deliveries",
    headers={"Authorization": f"Bearer {os.environ['CODESPAR_API_KEY']}"},
)
res.raise_for_status()
data = res.json()
const res = await fetch("https://api.codespar.dev/v1/webhook-deliveries", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.CODESPAR_API_KEY}`,
  },
});

const data = await res.json();
const result = await cs.api.get("/v1/webhook-deliveries");
Example response 200
application/json
{
  "deliveries": [
    {
      "id": "obj_0000000000000000",
      "trigger_id": "trg_0000000000000000",
      "trigger_name": "Example",
      "event_id": "event_0000000000000000",
      "event_type": "string",
      "status": "string",
      "response_status": 0,
      "error": "string",
      "attempt": 0,
      "created_at": "2026-01-15T12:00:00.000Z",
      "delivered_at": "2026-01-15T12:00:00.000Z"
    }
  ],
  "next_before": "string",
  "total": 0
}
Webhook Deliveries | CodeSpar