Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hookdeck Requests API

List and inspect raw requests received by Hookdeck. A request precedes events and is what gets accepted at the gateway boundary before verification, fan-out, transformation, and routing produce one or more downstream events.

Hookdeck Requests API is one of 17 APIs that Hookdeck publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Webhooks, Requests, and Event Gateways. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 JSON Schema.

This API exposes 6 operations across 6 paths, and defines 20 schemas. It is described by OpenAPI 3.0.1, at version 1.0.0.

Requests are made against a single base URL, https://api.hookdeck.com/2025-07-01.

6 operations 6 paths 20 schemas 5 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0.0
Base URL
https://api.hookdeck.com/2025-07-01
Authentication
HTTP Bearer, HTTP Basic
Resource Areas
1

Authentication & Security 2

Hookdeck Requests API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 5 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Requests 6

A request represent a webhook received by Hookdeck.

GET
/requests
Retrieve requests
getRequests 23 params → 200400422
GET
/requests/{id}
Retrieve a request
getRequest 1 param → 200404
GET
/requests/{id}/raw_body
Get a request raw body data
getRequestRawBody 1 param → 200404
POST
/requests/{id}/retry
Retry a request
retryRequest 1 param body → 200400404422
GET
/requests/{id}/events
Retrieve request events
getRequestEvents 30 params → 200400404422
GET
/requests/{id}/ignored_events
Retrieve request ignored events
getRequestIgnoredEvents 7 params → 200400404422

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are Event (18 properties), Request (13 properties), EventData (9 properties), IgnoredEvent (7 properties). Each schema is shown below with its type and property counts.

RequestRejectionCause
string
IgnoredEventPaginatedResult
object
3 properties
Request
object
13 properties 12 required
RetryRequest
object
2 properties 1 required
RawBody
object
1 property 1 required
AttemptErrorCodes
string
Error code of the delivery attempt
FilteredMeta
array
Event
object
18 properties 15 required
APIErrorResponse
object
Error response model
4 properties 3 required
Operators
object
6 properties
OrderByDirection
IgnoredEventCause
string
IgnoredEvent
object
7 properties 6 required
EventPaginatedResult
object
3 properties
EventData
object
Event data if included
9 properties 7 required
EventStatus
string
SeekPagination
object
5 properties
TransformationFailedMeta
object
1 property 1 required
ShortEventData
object
Request data
6 properties 5 required
RequestPaginatedResult
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hookdeck-requests-api-openapi.yml Raw ↑

Other APIs Hookdeck publishes across the network.

Hookdeck Connections API
Hookdeck Sources API
Hookdeck Destinations API
Hookdeck Events API
Hookdeck Transformations API
Hookdeck Bookmarks API
Hookdeck Issues API
Hookdeck Metrics API
Hookdeck Integrations API
Hookdeck Notifications API
Hookdeck Attempts API
Hookdeck Bulk cancel events API