Get Delivery

Retrieve a single webhook delivery attempt by ID.

GET /webhooks/indexing/deliveries/{delivery_id}

Get a single webhook delivery attempt

Python

import requests

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

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

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

print(response.text)

200

{
  "data": {
    "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"
  },
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "collection": "team_docs",
    "database": "acme_corp",
    "latency_ms": 12.3,
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "source_type": "file",
    "sub_tenant_id": "sub_tenant_4567",
    "tenant_id": "tenant_1234"
  },
  "success": true
}

Returns one delivery record, including its current status, attempt count, and the last error code and message when an attempt failed.

The delivery_id is the value sent in the X-HydraDB-Delivery-ID header of the delivery itself, so you can look up any request your endpoint received. See Webhooks.

Authorizations

Authorization · string · header · required

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

Path Parameters

delivery_id · string · required

Delivery ID

Example:

"dlv_9f8e7d6c"

Response

200

application/json

OK

data · object

Show child attributes

Example:

{
  "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"
}

error · object

Error message, empty string on success.

Show child attributes

Example:

{
  "code": "DATABASE_NOT_FOUND",
  "message": "Database not found"
}

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": "sub_tenant_4567",
  "tenant_id": "tenant_1234"
}

success · boolean

Whether the request succeeded.

Example:

true