hooks

List or long-poll captured requests

Summaries ordered oldest-first by received_at, at most 100 per response; bodies stay on the detail endpoint. Long-poll semantics match the email endpoint.

get/v1/hooks/{id}/requests

Request

  • Base URL: https://api.mailfixture.com
  • URL: https://api.mailfixture.com/v1/hooks/{id}/requests
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Hook id.

Query parameters

sincestring date-time

Only items (messages, SMS, or captured requests) received strictly after this RFC 3339 timestamp. Feed back the last summary's received_at as a cursor — the row carrying that exact timestamp is not repeated.

matchstring

Filter expression: method:<verb> (exact, case-insensitive), path:<term> or body:<term> (case-insensitive substring); a bare term (or unknown prefix) matches the body. Body matching scans the first 32 KiB of body bytes; detail responses still return the complete body.

waitinteger

Long-poll window in seconds; default 0 answers immediately. Clamped to 60 — larger values are accepted and treated as 60. The request returns as soon as a matching item arrives; an empty window still answers 200 with an empty list.

Response

Matching captured requests — empty array when nothing matched within the wait window.

Changes

No recorded changes to this operation across all 1 revision of this API.