DAdatadog
RUM Recovery

List batch recovery requests

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.

get/api/v2/rum/recover/requests

Request

Query parameters

type'batch' required

Query-based batch recovery.

Example:batch

Must equal batch.

limitinteger

Number of results returned per page, at most 100 (default 50). Omitted, zero, or negative values use 50. Invalid integers return 400.

cursorstring

Opaque next-page cursor. Keep type, from, to, and query unchanged between pages.

frominteger

Start of the request creation-time range in Unix milliseconds, inclusive. This filters created_at, not the time range of the sessions being recovered. Must be earlier than to when both are provided.

tointeger

End of the request creation-time range in Unix milliseconds, exclusive. This filters created_at, not the time range of the sessions being recovered. Must be later than from when both are provided.

querystring

Filter recovery requests whose stored query selects matching facet values. Supports facet:value and facet:(A OR B) terms combined with AND, including * and ? wildcards in filter values. Attribute facets keep their leading @. At most 4096 bytes. Exclusions, repeated facets, free text, ranges, and OR between terms return 400. Stored queries that cannot be matched unambiguously are excluded. Blank values apply no query filter.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2026-09-21T12:00:00Z",
        "discovery_status": "QUEUED",
        "from": 1789905600000,
        "query": "service:web",
        "status": "PENDING",
        "to": 1789992000000,
        "updated_at": "2026-09-21T12:00:00Z"
      },
      "id": "11111111-1111-4111-8111-111111111111",
      "type": "rum_batch_recovery_request"
    }
  ],
  "meta": {
    "next_cursor": "example"
  }
}

Changes

Changes to this operation have not been checked yet.