---
title: "Retrieve requests"
method: GET
path: "/requests"
tags: ["Requests"]
---

# Retrieve requests

`GET /requests`

This endpoint lists requests, or a subset of requests.

## Query parameters

- `id` union — Filter by requests IDs
  - string — Request ID
  - string[]
- `status` 'accepted' | 'rejected' — Filter by status
- `rejection_cause` union — Filter by rejection cause
  - 'SOURCE_DISABLED' | 'NO_CONNECTION' | 'VERIFICATION_FAILED' | 'UNSUPPORTED_HTTP_METHOD' | 'UNSUPPORTED_CONTENT_TYPE' | 'UNPARSABLE_JSON' | 'PAYLOAD_TOO_LARGE' | 'INGESTION_FATAL' | 'UNKNOWN'
  - RequestRejectionCause[]
- `source_id` union — Filter by source IDs
  - string — Source ID
  - string[]
- `verified` boolean — Filter by verification status
- `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
- `ignored_count` union — Filter by count of ignored events
  - 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[]
- `events_count` union — Filter by count of events
  - 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[]
- `cli_events_count` union — Filter by count of CLI events
  - 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[]
- `created_at` union — Filter by request created date
  - 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
- `ingested_at` union — Filter by request ingested date
  - 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
- `bulk_retry_id` union
  - string
  - string[]
- `include` 'data'
- `progressive` 'true' | 'false' — Enable progressive loading for partial results
- `order_by` 'created_at' | 'ingested_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 requests

- RequestPaginatedResult
  - `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` Request[]
    - `id` string, required — ID of the request
    - `team_id` string, required — ID of the project
    - `verified` boolean, nullable, required — Whether or not the request was verified when received
    - `original_event_data_id` string, nullable, required — ID of the request data
    - `rejection_cause` 'SOURCE_DISABLED' | 'NO_CONNECTION' | 'VERIFICATION_FAILED' | 'UNSUPPORTED_HTTP_METHOD' | 'UNSUPPORTED_CONTENT_TYPE' | 'UNPARSABLE_JSON' | 'PAYLOAD_TOO_LARGE' | 'INGESTION_FATAL' | 'UNKNOWN', required
    - `ingested_at` string, date-time, nullable, required — The time the request was originally received
    - `source_id` string, required — ID of the associated source
    - `events_count` integer, nullable, required — The count of events created from this request (CLI events not included)
    - `cli_events_count` integer, nullable, required — The count of CLI events created from this request
    - `ignored_count` integer, nullable, required
    - `updated_at` string, date-time, required — Date the event was last updated
    - `created_at` string, date-time, required — Date the event was created
    - `data` ShortEventData, nullable — Request data
      - `path` string, required — Request path
      - `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
      - `body` union, required — JSON or string representation of the body
        - string
        - object
        - unknown[]
          - unknown
      - `is_large_payload` boolean, nullable — Whether the payload is considered large payload and not searchable

## Other responses

- `400` — Bad Request
- `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)