Skip to main content
GET
Callback status
Shows whether the webhook for a request submitted with a callback URL was delivered: its state, attempts, the last status your server answered and the next retry. Free. Only the callback host is kept, never its path or query. See Async requests and webhooks.

Authorizations

x-api-key
string
header
required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys?utm_source=docs&utm_medium=referral

Path Parameters

request_id
string
required

Response

Successful Response

Webhook delivery state of a call submitted with a callback URL.

request_id
string
required
state
enum<string>
required

pending: the call is still running. delivering: an attempt is under way or the next retry is due at next_attempt_at. delivered: the endpoint answered 2xx. failed: every attempt failed, a final status (not 408/429/5xx) came back, or a gateway restart interrupted the delivery (last_error "interrupted (gateway restart)").

Available options:
pending,
delivering,
delivered,
failed
attempts
integer
required
callback_host
string
required

Host of the callback URL only (never its path or query).

last_status
integer | null

HTTP status of the last attempt.

last_error
string | null

Short error class of the last attempt, e.g. HTTP 503, timeout.

next_attempt_at
integer | null

Unix time of the next retry.

delivered_at
integer | null

Unix time.