GET /webhooks
List webhook delivery history with status and retry info.
GET /webhooks
Retrieve the history of webhook deliveries for your partner account. Use this to debug delivery issues or verify event receipt.
Request
curl -H "X-API-Key: mp2p_test_xxx" \
"https://mexicop2p.org/api/v1/webhooks?status=FAILED&limit=10"Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | — | Filter: PENDING, DELIVERED, FAILED |
orderId | string | — | Filter by order ID |
eventType | string | — | Filter by event type (e.g. order.completed) |
limit | number | 20 | Max results (1–100) |
offset | number | 0 | Pagination offset |
Response 200
{
"deliveries": [
{
"id": "del_abc123",
"orderId": "ord_xyz789",
"eventType": "order.completed",
"status": "DELIVERED",
"attempts": 1,
"maxAttempts": 5,
"lastAttemptAt": "2025-06-15T12:35:01.000Z",
"nextAttemptAt": null,
"deliveredAt": "2025-06-15T12:35:01.000Z",
"errorMessage": null,
"createdAt": "2025-06-15T12:35:00.000Z"
},
{
"id": "del_def456",
"orderId": "ord_xyz789",
"eventType": "order.locked",
"status": "FAILED",
"attempts": 5,
"maxAttempts": 5,
"lastAttemptAt": "2025-06-15T14:35:00.000Z",
"nextAttemptAt": null,
"deliveredAt": null,
"errorMessage": "Connection timeout after 10s",
"createdAt": "2025-06-15T12:15:00.000Z"
}
],
"total": 2,
"limit": 10,
"offset": 0,
"hasMore": false
}Delivery fields
| Field | Type | Description |
|---|---|---|
id | string | Unique delivery ID |
orderId | string | Related order |
eventType | string | Webhook event type |
status | string | PENDING, DELIVERED, or FAILED |
attempts | number | Number of delivery attempts made |
maxAttempts | number | Maximum attempts (5) |
lastAttemptAt | string|null | Last attempt timestamp |
nextAttemptAt | string|null | Next retry timestamp (if pending) |
deliveredAt | string|null | Successful delivery timestamp |
errorMessage | string|null | Error details (if failed) |
createdAt | string | When the delivery was queued |