---
title: "Generate requests bulk retry plan"
method: GET
path: "/bulk/requests/retry/plan"
tags: ["Bulk retry requests"]
---

# Generate requests bulk retry plan

`GET /bulk/requests/retry/plan`

This endpoint estimates the number of requests matched by the provided query before creating a bulk retry.

## Query parameters

- `query` object — Filter properties for the events to be included in the bulk retry, use query parameters of [Requests](#requests)
  - `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[]

## Response `200`

Requests bulk retry plan

- object
  - `estimated_batch` integer, nullable — Number of batches required to complete the bulk retry
  - `estimated_count` integer, nullable — Number of estimated events to be retried
  - `progress` number, float, nullable — Progression of the batch operations, values 0 - 1

## 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)