---
title: "Get participant status reason details"
method: GET
path: "/participant/{participant_code}/status_reason"
tags: ["Query Participants"]
---

# Get participant status reason details

`GET /participant/{participant_code}/status_reason`

## Request

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

Returns detailed information about a participant's current status, including lock, disable, close, or divest reason codes along with compliance and KYC reasons when applicable. Availability is gated per platform; contact zerohash to enable for your platform.

## Path parameters

- `participant_code` string, required

## Headers

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

## Response `200`

Successfully retrieved participant status reason details. including the current status and the reason codes that apply for locked, disabled, closed, or divested participants.

- GetParticipantStatusReasonResponse
  - `message` object
    - `participant_code` string: Unique participant code
    - `status` string: The current status of the participant
    - `lock_reason` string: Reason code for locked participants
    - `disable_reason` string: Reason code for disabled participants
    - `close_reason` string: Reason code for closed participants
    - `divest_reason` string: Reason code for divested participants
    - `compliance_reasons` string[]: Array of compliance issue reason codes
    - `notes` string: Additional notes about the participant status
    - `case_number` string: Case number associated with the participant status
    - `kyc_reasons` string[]: Array of KYC-related reason codes

## 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/participant/:participant_code/status_reason/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)