---
title: "Get reclaims with filtering"
method: GET
path: "/reclaims"
tags: ["General APIs with JWT"]
---

# Get reclaims with filtering

`GET /reclaims`

Endpoint to retrieve reclaims with comprehensive filtering options. Supports filtering by status, executor_id, reclaim_id (blockchain), miner_hotkey, expired_only, and pending_only.

## Query parameters

- `status` string, nullable
- `executor_id` string, uuid, nullable
- `reclaim_id` integer, nullable
- `miner_hotkey` string, nullable
- `expired_only` boolean, nullable
- `pending_only` boolean, nullable

## Response `200`

Reclaims retrieved successfully

- ReclaimListResponse[]
  - `id` string, uuid, required
  - `reclaim_id` integer, required
  - `status` string, required
  - `expiration` string, date-time, required
  - `executor_id` string, uuid, nullable, required
  - `collateral_amount` number, required
  - `requested_at` string, date-time, required
  - `processed_at` string, date-time, nullable
  - `is_expired` boolean, required
  - `can_be_processed` boolean, required

## Other responses

- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/57db0a9348db/schema)