Skip to content

List inbound webhook requests

GET
/v1/requests

Every inbound request the front door received — including ones with no matching endpoint (outcome=dropped_unknown) or a paused endpoint (parked_inactive) — captured by the router for debugging. Filter by endpoint, outcome, and time.

Authorizations

apiKey

Scoped API key. Scopes are readwriteadmin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Parameters

Query Parameters

endpoint

Filter to one endpoint id.

Type
string
outcome
Type
string
Valid values
"accepted""dropped_unknown""parked_inactive"
since
Type
string
Format
"date-time"
until
Type
string
Format
"date-time"
cursor

Opaque pagination cursor; pass back next_cursor from the previous page.

Type
string

Responses

A page of inbound requests (newest first).

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"request_id": "01JX9ABCDDEF0123456789ABCD",
  
  
  
"endpoint_id": "ep_01JX9",
  
  
  
"receive_url": "https://wh.emhk.in/acme/shopify-store/orders",
  
  
  
"host": "wh.emhk.in",
  
  
  
"method": "POST",
  
  
  
"path": "orders",
  
  
  
"size_bytes": 842,
  
  
  
"verdict": {
  
  
  
  
"scheme": "generic-hmac",
  
  
  
  
"result": "pass"
  
  
  
},
  
  
  
"outcome": "accepted",
  
  
  
"source_ip": "203.0.113.7",
  
  
  
"received_at": "string",
  
  
  
"headers": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"body": "string"
  
  
}
  
],
  
"next_cursor": "string"
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

Emithook · a Finnoto product