List Deliveries

List webhook delivery attempts for your workspace.

GET /webhooks/indexing/deliveries

List recent webhook delivery attempts

Python

import requests

url = "https://api.hydradb.com/webhooks/indexing/deliveries"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "data": {
    "count": 12,
    "deliveries": [
      {
        "attempts": 1,
        "created_at": "2026-07-02T10:00:00Z",
        "delivery_id": "dlv_9f8e7d6c",
        "doc_id": "HydraDoc1234",
        "error_code": "",
        "error_message": "",
        "event_type": "indexing.status_changed",
        "indexing_status": "completed",
        "status": "completed",
        "updated_at": "2026-07-02T10:00:05Z"
      }
    ],
    "next_cursor": "eyJvZmZzZXQiOjUwfQ=="
  },
  "error": null,
  "meta": {
    "collection": "team_docs",
    "database": "acme_corp",
    "latency_ms": 12.3,
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "source_type": "file",
    "sub_tenant_id": "team_docs",
    "tenant_id": "acme_corp"
  },
  "success": true
}

Returns the delivery history for your workspace, most recent first. Use it to investigate events that never arrived, or that arrived more than once.

Filter by status to isolate failures, and page through results with limit and cursor.

State	Meaning
pending	Recorded and waiting to be sent.
sweeping	Claimed for delivery or retry.
delivered	Your endpoint returned a 2xx.
failed	An attempt failed and will be retried.
permanently_failed	Retries are exhausted. No further attempts.

limit is 1 to 100 (default 20). To get the next page, pass the response’s next_cursor as cursor. next_cursor is null on the last page. A limit outside that range returns 422, and an unknown status returns 400.

See Webhooks for retry behaviour.

Authorizations

Authorization · string · header · required

API key sent as a Bearer token: "Bearer prefix.secret"

Query Parameters

limit · integer

Max deliveries to return

cursor · string

Pagination cursor

status · string

Filter by delivery status

Response

200 - application/json

OK

data · object

Show child attributes

Example:

{
  "count": 12,
  "deliveries": [
    {
      "attempts": 1,
      "created_at": "2026-07-02T10:00:00Z",
      "delivery_id": "dlv_9f8e7d6c",
      "doc_id": "HydraDoc1234",
      "error_code": "",
      "error_message": "",
      "event_type": "indexing.status_changed",
      "indexing_status": "completed",
      "status": "completed",
      "updated_at": "2026-07-02T10:00:05Z"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ=="
}

error · object | null

Null on success; an object with code and message on failure.

Show child attributes

Example:

null

meta · object

Show child attributes

Example:

{
  "collection": "team_docs",
  "database": "acme_corp",
  "latency_ms": 12.3,
  "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
  "source_type": "file",
  "sub_tenant_id": "team_docs",
  "tenant_id": "acme_corp"
}

success · boolean

Whether the request succeeded.

Example:

true