---
title: "List all KYC statuses"
method: GET
path: "/v2/kyc/status"
tags: ["Kyc"]
---

# List all KYC statuses

`GET /v2/kyc/status`

List all KYC statuses based on the provided filters.

## Query parameters

- `userId` string
- `userName` string
- `userEmail` string
- `rails` 'USD' | 'SOUTH_AMERICA_STANDARD' | 'AFRICA_GENERAL' | 'AFRICA_NIGERIA' | 'GLOBAL_NETWORK' | 'USD_FIAT' — The type of rail.
- `status` KycStatusEnum[]
- `limit` string
- `createdBefore` string, date
- `createdAfter` string, date

## Response `200`

Success

- object[]
  - `user` object
    - `id` string, uuid
    - `type` 'individual' | 'business'
    - `name` string
    - `email` string, email
  - `rails` 'USD' | 'SOUTH_AMERICA_STANDARD' | 'AFRICA_GENERAL' | 'AFRICA_NIGERIA' | 'GLOBAL_NETWORK' | 'USD_FIAT' — The type of rail.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `status` 'INACTIVE' | 'CREATED' | 'PENDING' | 'INCOMPLETE' | 'RFI_PENDING' | 'ACTIVE' | 'REJECTED' | 'CONTACT_SUPPORT' — Kyc Status - `INACTIVE`: No KYC submission has been made. - `CREATED`: KYC application has been submitted. - `PENDING`: Review in progress. - `RFI_PENDING`: An RFI (Request for Information) email has been sent and is pending user response. - `INCOMPLETE`: RFI or resubmission required. - `ACTIVE`: User approved and onboarded. - `REJECTED`: KYC application rejected. - `CONTACT_SUPPORT`: Unexpected issue encountered during KYC review.

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/hifi/apis/hifi-api.md) · [All operations](https://skmtc.net/hifi/apis/hifi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hifi/hifi-api/revisions/15a39c342fd1/schema)