---
title: "Get recovery request progress"
method: GET
path: "/api/v2/rum/recover/requests/{request_id}"
tags: ["RUM Recovery"]
---

# Get recovery request progress

`GET /api/v2/rum/recover/requests/{request_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/rum/recover/requests/{request_id}`
- 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/:request_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get progress for a targeted or batch recovery request. A `COMPLETED` request can include failed sessions; check individual session statuses for targeted recovery.

## Path parameters

- `request_id` string, uuid, required: Request identifier.

## Response `200`

OK

- RumRecoveryRequestResponse: JSON:API document.
  - `data` RumRecoveryRequestData, required: JSON:API resource.
    - `attributes` RumRecoveryRequestAttributes, required: Recovery progress. Batch-only attributes are omitted for targeted requests; request_type is also omitted for targeted requests.
      - `created_at` string, date-time, required: Creation time.
      - `discovery_status` 'QUEUED' | 'PENDING' | 'SLICING' | 'DISCOVERED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED': Batch discovery state. QUEUED indicates that the request is waiting for processing capacity.
      - `error_message` string: Failure details, if present.
      - `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.
      - `failed_sessions` integer, required: Failed session count.
      - `from` integer: Start of the range in Unix milliseconds. Must be positive and earlier than to.
      - `processed_sessions` integer, required: Processed session count.
      - `query` string: RUM search query. Not blank, at most 4096 bytes for batch creation and count.
      - `request_type` 'batch': Query-based batch recovery.
      - `sessions` RumRecoveredSession[]: Targeted session progress. Omitted when empty or not applicable.
        - `application_id` string, uuid, required: Application UUID.
        - `error_message` string: Failure details, if present.
        - `events_recovered` integer, required: Recovered event count.
        - `session_id` string, uuid, required: Session identifier.
        - `status` 'AVAILABLE' | 'PENDING' | 'PROCESSING' | 'RECOVERED' | 'FAILED' | 'RETAINED' | 'EXPIRED' | 'CANCELLED', required: Session availability or recovery state. `RECOVERED` indicates that the session is ready to query.
      - `sessions_discovered` integer: Discovered sessions.
      - `sessions_failed` integer: Failed sessions.
      - `sessions_processed` integer: Processed sessions.
      - `slices_completed` integer: Completed slices.
      - `slices_failed` integer: Failed slices.
      - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'EXPIRED', required: Recovery request state.
      - `to` integer: End of the range in Unix milliseconds.
      - `total_sessions` integer: Total targeted sessions. Omitted while a batch total is unknown.
      - `total_slices` integer: Total discovery slices.
      - `updated_at` string, date-time, required: Last update time.
    - `id` string, required: Resource identifier.
    - `type` 'rum_recovery_request', required: JSON:API resource type.

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