--- title: "Retrieve request events" method: GET path: "/requests/{id}/events" tags: ["Requests"] --- # Retrieve request events `GET /requests/{id}/events` This endpoint retrieves all events that were created as a result of the specified request. ## Path parameters - `id` string, required — Request ID ## Query parameters - `id` union — Filter by event IDs - string — Event ID - string[] - `status` union — Lifecyle status of the event - 'SCHEDULED' | 'QUEUED' | 'HOLD' | 'SUCCESSFUL' | 'FAILED' | 'CANCELLED' - EventStatus[] - `webhook_id` union — Filter by connection (webhook) IDs - string — Connection (webhook) ID - string[] - `destination_id` union — Filter by destination IDs - string — Destination ID - string[] - `delivery_group` union — Filter by delivery group; null matches events without a delivery group - string - string[] - `source_id` union — Filter by source IDs - string — Source ID - string[] - `attempts` union — Filter by number of attempts - integer - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `response_status` union — Filter by HTTP response status code - integer - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - integer[] - `successful_at` union — Filter by `successful_at` date using a date operator - string, date-time - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `created_at` union — Filter by `created_at` date using a date operator - string, date-time - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `error_code` union — Filter by error code code - 'BAD_RESPONSE' | 'CANCELLED' | 'TIMEOUT' | 'NOT_FOUND' | 'CANCELLED_PAST_RETENTION' | 'CONNECTION_REFUSED' | 'CONNECTION_RESET' | 'MISSING_URL' | 'CLI' | 'CLI_UNAVAILABLE' | 'SELF_SIGNED_CERT' | 'ERR_TLS_CERT_ALTNAME_INVALID' | 'ERR_SSL_WRONG_VERSION_NUMBER' | 'NETWORK_ERROR' | 'NETWORK_REQUEST_CANCELED' | 'NETWORK_UNREACHABLE' | 'TOO_MANY_REDIRECTS' | 'INVALID_CHARACTER' | 'INVALID_URL' | 'SSL_ERROR_CA_UNKNOWN' | 'DATA_ARCHIVED' | 'SSL_CERT_EXPIRED' | 'BULK_RETRY_CANCELLED' | 'DNS_LOOKUP_FAILED' | 'HOST_UNREACHABLE' | 'INTERNAL_ERROR' | 'PROTOCOL_ERROR' | 'PAYLOAD_MISSING' | 'UNABLE_TO_GET_ISSUER_CERT' | 'SOCKET_CLOSED' | 'OAUTH2_HANDSHAKE_FAILED' | 'Z_DATA_ERROR' | 'UNKNOWN' — Error code of the delivery attempt - AttemptErrorCodes[] - `cli_id` union — Filter by CLI IDs. `?[any]=true` operator for any CLI. - string - object - `any` boolean - `all` boolean - string[] - `last_attempt_at` union — Filter by `last_attempt_at` date using a date operator - string, date-time - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `next_attempt_at` union — Filter by `next_attempt_at` date using a date operator - string, date-time - Operators - `gt` string, date-time, nullable - `gte` string, date-time, nullable - `le` string, date-time, nullable - `lte` string, date-time, nullable - `any` boolean - `all` boolean - `search_term` string — URL Encoded string of the value to match partially to the body, headers, parsed_query or path - `headers` union — URL Encoded string of the JSON to match to the data headers - string - object - `body` union — URL Encoded string of the JSON to match to the data body - string - object - `parsed_query` union — URL Encoded string of the JSON to match to the parsed query (JSON representation of the query) - string - object - `path` string — URL Encoded string of the value to match partially to the path - `cli_user_id` union - string - string[] - `issue_id` union - string - string[] - `event_data_id` union - string - string[] - `bulk_retry_id` union - string - string[] - `include` 'data' — Include the data object in the event model - `progressive` 'true' | 'false' — Enable progressive loading for partial results - `order_by` 'created_at' — Sort key - `dir` 'asc' | 'desc' — Sort direction - `limit` integer — Result set size - `next` string — The ID to provide in the query to get the next set of results - `prev` string — The ID to provide in the query to get the previous set of results ## Response `200` List of events - EventPaginatedResult - `pagination` SeekPagination - `order_by` union - string - string[] - `dir` union - union - 'asc' - 'desc' - 'ASC' - 'DESC' - OrderByDirection[] - union - 'asc' - 'desc' - 'ASC' - 'DESC' - `limit` integer - `prev` string - `next` string - `count` integer - `models` Event[] - `id` string, required — ID of the event - `team_id` string, required — ID of the project - `webhook_id` string, required — ID of the associated connection (webhook) - `source_id` string, required — ID of the associated source - `destination_id` string, required — ID of the associated destination - `delivery_group` string, nullable — Delivery group computed from the destination delivery groups config - `event_data_id` string, required — ID of the event data - `request_id` string, required — ID of the request that created the event - `attempts` integer, required — Number of delivery attempts made - `last_attempt_at` string, date-time, nullable, required — Date of the most recently attempted retry - `next_attempt_at` string, date-time, nullable, required — Date of the next scheduled retry - `response_status` integer, nullable — Event status - `error_code` 'BAD_RESPONSE' | 'CANCELLED' | 'TIMEOUT' | 'NOT_FOUND' | 'CANCELLED_PAST_RETENTION' | 'CONNECTION_REFUSED' | 'CONNECTION_RESET' | 'MISSING_URL' | 'CLI' | 'CLI_UNAVAILABLE' | 'SELF_SIGNED_CERT' | 'ERR_TLS_CERT_ALTNAME_INVALID' | 'ERR_SSL_WRONG_VERSION_NUMBER' | 'NETWORK_ERROR' | 'NETWORK_REQUEST_CANCELED' | 'NETWORK_UNREACHABLE' | 'TOO_MANY_REDIRECTS' | 'INVALID_CHARACTER' | 'INVALID_URL' | 'SSL_ERROR_CA_UNKNOWN' | 'DATA_ARCHIVED' | 'SSL_CERT_EXPIRED' | 'BULK_RETRY_CANCELLED' | 'DNS_LOOKUP_FAILED' | 'HOST_UNREACHABLE' | 'INTERNAL_ERROR' | 'PROTOCOL_ERROR' | 'PAYLOAD_MISSING' | 'UNABLE_TO_GET_ISSUER_CERT' | 'SOCKET_CLOSED' | 'OAUTH2_HANDSHAKE_FAILED' | 'Z_DATA_ERROR' | 'UNKNOWN' — Error code of the delivery attempt - `status` 'SCHEDULED' | 'QUEUED' | 'HOLD' | 'SUCCESSFUL' | 'FAILED' | 'CANCELLED', required - `successful_at` string, date-time, nullable, required — Date of the latest successful attempt - `cli_id` string, nullable, required — ID of the CLI the event is sent to - `updated_at` string, date-time, required — Date the event was last updated - `created_at` string, date-time, required — Date the event was created - `data` EventData, nullable — Event data if included - `url` string, required - `method` string, required - `path` string, nullable, required — Raw path string - `query` string, nullable, required — Raw query param string - `parsed_query` union, required — JSON representation of query params - string, nullable - object - `headers` union, required — JSON representation of the headers - string - object - `appended_headers` string[] — List of headers that were added by Hookdeck - `body` union, required — JSON or string representation of the body - string - object - unknown[] - unknown - `is_large_payload` boolean — Whether the payload is considered large payload and not searchable ## Other responses - `400` — Bad Request - `404` — Not Found - `422` — Unprocessable Entity --- [API](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/revisions/091808eac7fa/schema)