# Webhooks — Eto API

> Inspect and re-send the order events Eto pushes to your server.

Base URL `https://eto.tools/api/v1/`. Every request carries the `X-Eto-API-Key` header. Part of the [Eto API reference](https://eto.tools/dev/docs/).

## Endpoints in this category

- [GET /api/v1/webhooks/deliveries](https://eto.tools/dev/docs/webhooks/webhooks-deliveries.md): List webhook deliveries
- [POST /api/v1/webhooks/deliveries/{delivery_id}/retry](https://eto.tools/dev/docs/webhooks/webhook-delivery-retry.md): Re-send one webhook delivery

## GET /api/v1/webhooks/deliveries

List webhook deliveries

- Operation ID: `webhooks_deliveries`
- Slug: `webhooks-deliveries`
- Category: Webhooks
- Authentication: API key only. Reads or writes data Eto holds for your own account.
- HTML: https://eto.tools/dev/docs/#ep-webhooks-deliveries
- Markdown: https://eto.tools/dev/docs/webhooks/webhooks-deliveries.md

List recent outbound webhook deliveries from your Eto account, newest first. Pass `id` to fetch one delivery on its own, which is the only form that includes the full payload Eto sent. Verified against developer_api/webhook_views.py.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | query | `integer` | no | Fetch this one delivery instead of a page, including its full payload. Ids come from the `deliveries[].id` field of a list call. |
| `status` | query | `string` | no | Only deliveries in this state. Any other value is ignored. One of: `pending`, `success`, `failed`. |
| `limit` | query | `integer` | no | Page size. Values above 100 are clamped. Default: `25`. Constraints: max 100. |
| `offset` | query | `integer` | no | Pagination offset. Default: `0`. |

### Request

```bash
curl -X GET "https://eto.tools/api/v1/webhooks/deliveries?id=1&status=pending" \
  -H "X-Eto-API-Key: eto_your_key"
```

```python
import requests

url = "https://eto.tools/api/v1/webhooks/deliveries"
headers = {"X-Eto-API-Key": "eto_your_key"}
params = {
    "id": 1,
    "status": "pending"
}

response = requests.get(url, headers=headers, params=params, timeout=120)
response.raise_for_status()
print(response.json())
```

```javascript
const url = "https://eto.tools/api/v1/webhooks/deliveries?id=1&status=pending";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "X-Eto-API-Key": "eto_your_key",
  },
});
if (!response.ok) throw new Error(`Eto API ${response.status}`);
const data = await response.json();
```

### Response

```json
{
  "success": true,
  "total": 128,
  "limit": 25,
  "offset": 0,
  "deliveries": [
    {"id": 8842, "event_type": "order.paid", "status": "success", "response_status_code": 200}
  ]
}
```

### Errors

Failures answer with the shared error body described in the Errors section: `{"error": {"code", "status", "message", "hint", "docs"}}`. Branch on `code`, not on the message.


## POST /api/v1/webhooks/deliveries/{delivery_id}/retry

Re-send one webhook delivery

- Operation ID: `webhook_delivery_retry`
- Slug: `webhook-delivery-retry`
- Category: Webhooks
- Authentication: API key only. Reads or writes data Eto holds for your own account.
- HTML: https://eto.tools/dev/docs/#ep-webhook-delivery-retry
- Markdown: https://eto.tools/dev/docs/webhooks/webhook-delivery-retry.md

Re-deliver exactly one past webhook delivery — the single delivery_id you pass — to your currently configured URL, and return the new outcome (success, response_status_code, error). It never re-sends anything else. Find delivery ids with GET /api/v1/webhooks/deliveries.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `delivery_id` | path | `integer` | yes | Id of the delivery to re-send, from GET /api/v1/webhooks/deliveries. |

### Request

```bash
curl -X POST "https://eto.tools/api/v1/webhooks/deliveries/8842/retry" \
  -H "X-Eto-API-Key: eto_your_key"
```

```python
import requests

url = "https://eto.tools/api/v1/webhooks/deliveries/8842/retry"
headers = {"X-Eto-API-Key": "eto_your_key"}

response = requests.post(url, headers=headers, timeout=120)
response.raise_for_status()
print(response.json())
```

```javascript
const url = "https://eto.tools/api/v1/webhooks/deliveries/8842/retry";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "X-Eto-API-Key": "eto_your_key",
  },
});
if (!response.ok) throw new Error(`Eto API ${response.status}`);
const data = await response.json();
```

### Response

`application/json`. This endpoint has no worked response example in the registry yet; the [HTML reference](https://eto.tools/dev/docs/#ep-webhook-delivery-retry) shows the fields it returns.

### Errors

Failures answer with the shared error body described in the Errors section: `{"error": {"code", "status", "message", "hint", "docs"}}`. Branch on `code`, not on the message.