For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDashboard
GuidesAPI Reference
GuidesAPI Reference
  • Endpoints
      • GETTab counts for the loads list
      • GETGet calls for a load
      • GETGet failed carrier verifications for a load
      • GETGet active escalations for a load
      • GETList webhook endpoints
      • POSTRegister a webhook endpoint
      • GETGet a webhook endpoint
      • DELDelete a webhook endpoint
      • PATCHUpdate a webhook endpoint
      • POSTRotate the signing secret
      • GETList delivery attempts for an endpoint
      • GETList attempts for a logical message
      • POSTReplay a delivery
      • GETList subscribable event types
LogoLogo
SupportDashboard
EndpointsAPI

List delivery attempts for an endpoint

GET
/webhooks/endpoints/:endpoint_id/messages
GET
/api/v1/webhooks/endpoints/:endpoint_id/messages
$curl https://tryenvoy.ai/api/v1/webhooks/endpoints/endpoint_id/messages \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "data": [
3    {
4      "id": "atmp_3f8a1c2b-9d4e-4f7a-bb2d-1a2c3d4e5f67",
5      "message_id": "msg_7e4b2a1c-8d9f-4c3b-a2d1-5f6e7d8c9b0a",
6      "endpoint_id": "ep_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
7      "attempt": 2,
8      "max_attempts": 5,
9      "status": "FAILED",
10      "next_attempt_at": "2024-06-10T14:45:00Z",
11      "response_status_code": 500,
12      "response_body_excerpt": "Internal Server Error",
13      "error_message": "Timeout while connecting to endpoint",
14      "duration_ms": 1200,
15      "delivered_at": null,
16      "created_at": "2024-06-10T14:30:00Z",
17      "payload": {
18        "id": "evt_1234567890abcdef",
19        "type": "shipment.updated",
20        "timestamp": "2024-06-10T14:29:59Z",
21        "data": {
22          "shipment_id": "shp_abcdef1234567890",
23          "status": "in_transit",
24          "location": "Chicago, IL"
25        }
26      }
27    }
28  ],
29  "pagination": {
30    "page": 1,
31    "page_size": 20,
32    "total_count": 45,
33    "total_pages": 3,
34    "has_next": true,
35    "has_prev": false
36  }
37}

Authentication: Supports API key and bearer token authentication.

Was this page helpful?
Previous

List attempts for a logical message

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

endpoint_idstringRequiredformat: "uuid"

Headers

X-Organization-IDstring or nullOptional

Query parameters

statusenum or nullOptional
Per-attempt delivery state. ``SENDING`` is the transient state that prevents double-sends: the delivery task atomically flips ``PENDING → SENDING`` (compare-and-set on the row) before doing the outbound POST, so any other worker that picks up the same row from the sweeper backs off cleanly. Always a terminal status (SUCCEEDED/FAILED/DEAD) by the time the task returns.
Allowed values:
pageintegerOptional>=1Defaults to 1
page_sizeintegerOptional1-100Defaults to 20

Response

Successful Response
datalist of objects
List of items for the current page
paginationobject
Pagination metadata

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error

Per-attempt delivery state.

SENDING is the transient state that prevents double-sends: the delivery task atomically flips PENDING → SENDING (compare-and-set on the row) before doing the outbound POST, so any other worker that picks up the same row from the sweeper backs off cleanly. Always a terminal status (SUCCEEDED/FAILED/DEAD) by the time the task returns.