---
title: "List participant unstakes"
method: GET
path: "/stakes/{participant_code}/unstakes"
tags: ["Staking"]
---

# List participant unstakes

`GET /stakes/{participant_code}/unstakes`

## Request

- Base URL: `https://api.cert.zerohash.com`
- URL: `https://api.cert.zerohash.com/stakes/{participant_code}/unstakes`
- Auth: API key in header `X-SCX-API-KEY` and API key in header `X-SCX-PASSPHRASE`

List all unstakes for a participant with optional filtering by asset, status, creation time and completion time. Time filters take full RFC3339 timestamps; the rewards endpoint instead filters by calendar date with start_date and end_date. Returns paginated results with completion timestamps.

## Path parameters

- `participant_code` string, required

## Query parameters

- `asset` string
- `status` 'submitted' | 'queued' | 'canceled' | 'broadcasted' | 'confirmed' | 'unstaked' | 'failed'
- `account_label` string
- `created_after` string, date-time
- `created_before` string, date-time
- `completed_after` string, date-time
- `completed_before` string, date-time
- `page` integer
- `page_size` integer

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Unstakes retrieved successfully

- GetUnstakesResponse
  - `request_id` string: Request identifier
  - `message` object
    - `unstakes` UnstakeEntity[]: Deprecated: the list will be returned directly as the `message` array.
      - `unstake_id` string: The unique identifier of the unstake request
      - `participant_code` string: Participant identifier
      - `asset` string: Asset being unstaked
      - `account_group` string: Account group
      - `account_label` string: Settlement account label
      - `amount` string: Amount being unstaked
      - `status` 'submitted' | 'queued' | 'canceled' | 'broadcasted' | 'confirmed' | 'unstaked' | 'failed': Current status of the unstake
      - `created_at` string, date-time: Timestamp when unstake was created
      - `completed_at` string, date-time: Timestamp when unstake reached terminal completed status. Null until completion.
      - `tx_hash` string: On-chain transaction hash for the unstake. Present once the unstake has been broadcast.
  - `page` integer: Current page number
  - `total_pages` integer: Total number of pages

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-03** `47cf70ae701c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zerohash/apis/zerohash-api/changes/stakes/:participant_code/unstakes/get.md)

---

[API](https://skmtc.dev/zerohash/apis/zerohash-api.md) - [All operations](https://skmtc.dev/zerohash/apis/zerohash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerohash/apis/zerohash-api/revisions/47cf70ae701c?raw)