---
title: "Get KYC Identity"
method: GET
path: "/api/evs/v1/identity"
tags: ["Know Your Customer (KYC)"]
---

# Get KYC Identity

`GET /api/evs/v1/identity`

Get a KYC identity of a user.

## Query parameters

- `organizationId` string
- `enterpriseId` string
- `userId` string
- `identityId` string
- `allData` boolean

## Response `200`

OK

- IdentityGetResponse
  - `identities` object[], required
    - `id` string, required
    - `status` string, required — The status of the KYC identity: `initiating`, `awaiting document upload`, `input error`, `ssn error`, `taxid error`, `in review`, `incomplete verifications`, `awaiting signature`, `records uploaded`, `approved`, `declined`
    - `organizationId` string
    - `enterpriseId` string
    - `userId` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `errorDescription` string
    - `occupation` string
    - `annualIncome` string
    - `netWorth` string
    - `sourceOfFunds` string
    - `sourceOfNetWorth` string
    - `countryOfCitizenship` string
    - `govIdCountryOfIssuance` string
    - `politicallyExposedPerson` boolean
    - `debugStatus` string
    - `country` string
    - `countryOfResidence` string
    - `addressCity` string
    - `addressPostalCode` string
    - `addressStreet1` string
    - `addressStreet2` string
    - `addressSubdivision` string
    - `birthDate` string, date-time
    - `birthdate` string, date-time
    - `identificationNumber` string
    - `nameFirst` string
    - `nameLast` string
    - `nameMiddle` string
    - `phoneNumber` string
    - `selectedIdClass` string
    - `debugFailureReason` string
    - `emailAddress` string
    - `contractSignerNameFull` string
    - `contractSignedDate` string, date-time
    - `contractSignedIPAddress` string
    - `contractVersion` string
    - `userAgreesToTerms` string
    - `signatureSubmitted` string
    - `signaturesSubmitted` string[]
    - `signaturesRequired` string[]

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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