---
title: "Get participant KYC status"
method: GET
path: "/participant/{participant_code}/kyc_status"
tags: ["Query Participants"]
---

# Get participant KYC status

`GET /participant/{participant_code}/kyc_status`

This endpoint returns KYC Status information attached to a participant.

## Path parameters

- `participant_code` string, required

## Headers

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

## Response `200`

Successfully retrieved participant KYC status. Including verification tier, status, and approval timestamps.

- GetParticipantKYCStatusResponse
  - `message` object
    - `participant_code` string — Unique participant code
    - `idv` 'unknown' | 'pass' | 'fail' | 'not_applicable' — Identity Verification Status
    - `liveness_check` 'unknown' | 'pass' | 'fail' | 'not_applicable' — Biometric Identity Verification Status
    - `tax_id` boolean — Participant has provided a Tax ID
    - `edd` boolean — Participant has provided information for Enhanced Due Diligence
    - `edd_required` boolean — Enhanced Due Diligence is required for the Participant and needs to be provided to move forward with onboarding
    - `tags` string[] — Tags associated with KYC Tier of Participant
    - `participant_status` string — The current status of the participant
    - `kyc_attempts` number — The number of KYC attempts the participant has gone through
    - `email_screening` 'passed' | 'failed' | 'error' — Whether the participant passed email screening

## Other responses

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

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/versions/8b647d934363/schema)