> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WebhookDelivery Schema

> One delivery attempt record for one event to one endpoint. Includes parameters, response shapes, examples, and implementation notes from the 0xArchive contract.

Source OpenAPI: 0xArchive API 1.7.0; 218 paths; 210 component schemas.

One delivery attempt record for one event to one endpoint. An event and an endpoint share a single row for their whole life, so a repeat delivery rewrites this record rather than adding another.

## Required Fields

| Field | Type | Description |
| - | - | - |
| `attempts` | integer:int32 | Attempts made so far. |
| `created_at` | string:date-time | When the delivery was queued. |
| `event_id` | string:uuid | Event identifier, stable across retries and repeat deliveries. |
| `event_type` | string | Event type delivered. |
| `id` | string:uuid | Delivery identifier. |
| `next_attempt_at` | string:date-time | When the next attempt is due. |
| `payload` | object | The event body as sent, including its `id`, `type`, `schema_version`, `observed_at` and `data`. |
| `state` | string | `pending` is queued or waiting to retry, `delivered` landed, `failed` is the last attempt's result, and `exhausted` means the retry window closed without success. |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WebhookDelivery",
  "description": "One delivery attempt record for one event to one endpoint. An event and an endpoint share a single row for their whole life, so a repeat delivery rewrites this record rather than adding another.",
  "type": "object",
  "required": [
    "attempts",
    "created_at",
    "event_id",
    "event_type",
    "id",
    "next_attempt_at",
    "payload",
    "state"
  ],
  "properties": {
    "attempts": {
      "description": "Attempts made so far.",
      "type": "integer",
      "format": "int32",
      "example": 1
    },
    "created_at": {
      "description": "When the delivery was queued. A repeat delivery resets this to the moment it was requested.",
      "type": "string",
      "format": "date-time"
    },
    "delivered_at": {
      "description": "When the delivery landed. Null until it does.",
      "type": "string",
      "format": "date-time",
      "nullable": true
    },
    "event_id": {
      "description": "Event identifier, stable across retries and repeat deliveries. Deduplicate on this in your receiver.",
      "type": "string",
      "format": "uuid"
    },
    "event_type": {
      "description": "Event type delivered.",
      "type": "string",
      "example": "market.liquidation"
    },
    "id": {
      "description": "Delivery identifier.",
      "type": "string",
      "format": "uuid"
    },
    "last_error": {
      "description": "Why the last attempt failed. Null when it succeeded.",
      "type": "string",
      "nullable": true
    },
    "last_latency_ms": {
      "description": "How long the last attempt took, in milliseconds.",
      "type": "integer",
      "format": "int32",
      "nullable": true,
      "example": 142
    },
    "last_status_code": {
      "description": "HTTP status your receiver returned on the last attempt.",
      "type": "integer",
      "format": "int32",
      "nullable": true,
      "example": 200
    },
    "next_attempt_at": {
      "description": "When the next attempt is due.",
      "type": "string",
      "format": "date-time"
    },
    "payload": {
      "description": "The event body as sent, including its `id`, `type`, `schema_version`, `observed_at` and `data`.",
      "type": "object",
      "additionalProperties": true
    },
    "state": {
      "description": "`pending` is queued or waiting to retry, `delivered` landed, `failed` is the last attempt's result, and `exhausted` means the retry window closed without success.",
      "type": "string",
      "enum": [
        "pending",
        "delivered",
        "failed",
        "exhausted"
      ],
      "example": "delivered"
    }
  }
}
```

## Referenced By

Use this shared schema with the generated component index and route-specific endpoint pages during implementation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.