Get Webhook event | ToAPIs Documentation

GET

/api/v1/webhook/events/{event_id}

Note for users in mainland China: Please use https://api.toapis.cn as the API endpoint (Base URL). Replace https://api.toapis.com with https://api.toapis.cn in the examples in this document.

Behavior

Returns a single delivery event's latest state and retry progress: event state, attempt count, last HTTP status, the redacted reason, and RFC 3339 timestamps.

The event payload, callback URL, receiver's raw response, details of the worker that performed delivery, and the full per-attempt log are not returned. Events of other accounts or that do not exist return 404.

Authentication

Authorizationstringheaderrequired

Use the system access token Bearer YOUR_SYSTEM_ACCESS_TOKEN. Access is limited to your own account. Model keys are not accepted. X-User-Id is not required. There is no administrator or team bypass.

Request parameters

event_idstringpathrequired

Event ID.

A missing event_id or one owned by another account returns 404; rate limiting returns 429.

Request examples

requestExample

curl --request GET \
  --url 'https://api.toapis.com/api/v1/webhook/events/evt_example' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'

Response examples

responseExample

{
  "code": 0,
  "message": "",
  "data": {
    "event_id": "evt_example",
    "api_key_id": 123,
    "task_id": "example-task",
    "type": "generation.completed",
    "status": "delivered",
    "attempts": 1,
    "reason": "delivered",
    "last_http_status": 200,
    "created_at": "2026-11-13T00:00:00Z",
    "next_attempt_at": null,
    "delivered_at": "2026-11-13T00:00:01Z",
    "expires_at": "2026-11-14T12:00:00Z"
  }
}

For the onboarding order and signature verification, see Get Webhook configuration.