---
title: "List batch recovery requests"
method: GET
path: "/api/v2/rum/recover/requests"
tags: ["RUM Recovery"]
---

# List batch recovery requests

`GET /api/v2/rum/recover/requests`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/rum/recover/requests`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/rum/recover/requests/get.ts> (a function with typed inputs; its response is checked against the schema)

List batch recovery requests for your organization. Set `type=batch`. Optional `from` and `to` bounds filter request creation time; `query` filters the queries stored on recovery requests.
A filtered page can be empty or contain fewer than `limit` results and still include `meta.next_cursor`. Continue until the cursor is absent, keeping the filters unchanged between pages.

## Query parameters

- `type` 'batch', required: Query-based batch recovery.
- `limit` integer
- `cursor` string
- `from` integer
- `to` integer
- `query` string

## Response `200`

OK

- RumRecoveryBatchListResponse: JSON:API document.
  - `data` RumRecoveryBatchListData[], required: Batch requests ordered newest first. A filtered page can be empty while meta.next_cursor is present.
    - `attributes` RumRecoveryBatchListAttributes, required: Batch recovery progress. Status updates can appear here before they appear in request details.
      - `created_at` string, date-time, required: Creation time.
      - `discovery_status` 'QUEUED' | 'PENDING' | 'SLICING' | 'DISCOVERED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required: Batch discovery state. QUEUED indicates that the request is waiting for processing capacity.
      - `estimated_count` integer: Batch estimate stored at creation, when present. New batches use a fresh server estimate; older batches may contain a client-supplied estimate.
      - `from` integer, required: Start of the range in Unix milliseconds. Must be positive and earlier than to.
      - `query` string, required: RUM search query. Not blank, at most 4096 bytes for batch creation and count.
      - `sessions_discovered` integer, required: Discovered sessions.
      - `sessions_failed` integer, required: Failed sessions.
      - `sessions_processed` integer, required: Processed sessions.
      - `slices_completed` integer, required: Completed slices.
      - `slices_failed` integer, required: Failed slices.
      - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'EXPIRED', required: Recovery request state.
      - `to` integer, required: End of the range in Unix milliseconds.
      - `total_slices` integer, required: Total discovery slices.
      - `updated_at` string, date-time, required: Last update time.
    - `id` string, required: Resource identifier.
    - `type` 'rum_batch_recovery_request', required: JSON:API resource type.
  - `meta` RumRecoveryBatchListMeta, required: Batch-list pagination metadata.
    - `next_cursor` string: Opaque next-page cursor. Omitted on the final page.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)