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

# Create KYC Identity

`POST /api/evs/v1/identity`

Create a KYC identity for a user.

## Request body

- union
  - object
    - `addressCity` string, required — The city of residence
    - `addressPostalCode` string — The postal or ZIP code
    - `addressStreet1` string, required — The street address line 1
    - `addressStreet2` string — The street address line 2
    - `addressSubdivision` string, required — The state, province, or region of residence
    - `birthdate` string, date, required — The birthdate of the individual (YYYY-MM-DD)
    - `country` string, required — The country of the address (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfCitizenship` string, required — The country of citizenship (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfResidence` string, required — The country of residence (ISO Alpha-2 or Alpha-3 country code)
    - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
    - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
    - `digitalAssetWalletAddress` string — A digital asset wallet address of the individual where funds will be deposited from
    - `enterpriseId` string, required — The BitGo enterprise ID
    - `govIdCountryOfIssuance` string, required — The country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code)
    - `identificationNumber` string — Tax identification number. Required for US citizens and US residents; optional for non-US individuals who hold one: - US citizens: Submit SSN (Social Security Number) - US residents (non-citizens): Submit SSN or ITIN (Individual Taxpayer Identification Number) - Non-US individuals: Optionally submit SSN or ITIN if held (e.g. dual nationals, former US residents). To upload other government-issued identification documents, use the [Submit KYC Documents](https://developers.bitgo.com/reference/entityvalidationidentitydocumentcreate) endpoint instead
    - `nameFirst` string, required — The first name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameLast` string, required — The last name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameMiddle` string — The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `notionalTradedEachMonth` number — The estimated notional amount traded per month in USD
    - `occupation` 'Agriculture' | 'Art Dealer / Auctioneer / Import / Export Company' | 'Financial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-Profit/Foundation/Endowment' | 'Computer Programmer / Administrator / Software Engineer / IT or Software / Technology Company' | 'Crypto Services (ATM, Exchange, Lender, Coins/Token)' | 'Education / Teacher' | 'Extractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious Metals' | 'Family Office' | 'Film / TV / Entertainment (not adult)' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Healthcare' | 'Law Enforcement / Military / Protective Services' | 'Miner / Mining Pool' | 'Money Service Business' | 'Other' | 'Private Equity / Venture Capital' | 'Professional Service Providers (lawyers accountants etc.)' | 'Real estate brokers developers and appraisers' | 'Recreation / Hospitality' | 'Student / Unemployed / Retired' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Other - Default' | 'Weapons Dealers', required
    - `organizationId` string, required — The Bitgo organization ID
    - `phoneNumber` string, required — The phone number of the individual
    - `politicallyExposedPerson` boolean, required — Whether the individual is a Politically Exposed Person (PEP)
    - `transactionType` 'institutionalIndividual', required — The type of KYC identity being created
    - `userId` string, required — The BitGo user ID
  - object
    - `birthdate` string, date, required — The birthdate of the individual (YYYY-MM-DD)
    - `country` string, required — The ISO Alpha-2 or Alpha-3 country code
    - `countryOfIncorporation` string — The country of incorporation (ISO Alpha-2 or Alpha-3 country code)
    - `dateOfIncorporation` string, date — The date of incorporation (YYYY-MM-DD)
    - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
    - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
    - `enterpriseId` string, required — The BitGo enterprise ID
    - `enterpriseName` string — The legal name of the business entity
    - `isEntity` boolean, required — Whether the account represents a business entity (true) or individual (false)
    - `nameFirst` string, required — The first name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameLast` string, required — The last name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameMiddle` string — The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `organizationId` string, required — The Bitgo organization ID
    - `transactionType` 'starterSignup', required — The type of transaction being created
    - `userId` string, required — The BitGo user ID
  - object
    - `birthdate` string, date, required — The birthdate of the individual (YYYY-MM-DD)
    - `country` string, required — The ISO Alpha-2 or Alpha-3 country code
    - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
    - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
    - `enterpriseId` string, required — The BitGo enterprise ID
    - `nameFirst` string, required — The first name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameLast` string, required — The last name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameMiddle` string — The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `organizationId` string, required — The Bitgo organization ID
    - `transactionType` 'kycInc', required — The type of KYC identity being created
    - `userId` string, required — The BitGo user ID
  - object
    - `birthdate` string, date, required — The birthdate of the individual (YYYY-MM-DD)
    - `country` string, required — The ISO Alpha-2 or Alpha-3 country code
    - `countryOfIncorporation` string — The country of incorporation (ISO Alpha-2 or Alpha-3 country code)
    - `dateOfIncorporation` string, date — The date of incorporation (YYYY-MM-DD)
    - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
    - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
    - `enterpriseId` string, required — The BitGo enterprise ID
    - `enterpriseName` string — The legal name of the individual or entity
    - `isEntity` boolean, required — Whether the account represents a business entity (true) or individual (false)
    - `isPrimaryContact` boolean — Whether this individual is the primary contact for the enterprise
    - `nameFirst` string, required — The first name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameLast` string, required — The last name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameMiddle` string — The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `organizationId` string, required — The Bitgo organization ID
    - `transactionType` 'unverifiedPayGoUser', required — The type of KYC identity being created
    - `userId` string, required — The BitGo user ID
  - object
    - `addressCity` string, required — The city of residence
    - `addressPostalCode` string — The postal or ZIP code
    - `addressStreet1` string, required — The street address line 1
    - `addressStreet2` string — The street address line 2
    - `addressSubdivision` string, required — The state, province, or region of residence
    - `birthdate` string, date, required — The birthdate of the individual (YYYY-MM-DD)
    - `country` string, required — The country of the address (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfCitizenship` string, required — The country of citizenship (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfResidence` string, required — The country of residence (ISO Alpha-2 or Alpha-3 country code)
    - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
    - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
    - `digitalAssetWalletAddress` string — A digital asset wallet address of the individual where funds will be deposited from
    - `enterpriseId` string, required — The BitGo enterprise ID
    - `govIdCountryOfIssuance` string, required — The country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code)
    - `identificationNumber` string — Tax identification number. Required for US citizens and US residents; optional for non-US individuals who hold one: - US citizens: Submit SSN (Social Security Number) - US residents (non-citizens): Submit SSN or ITIN (Individual Taxpayer Identification Number) - Non-US individuals: Optionally submit SSN or ITIN if held (e.g. dual nationals, former US residents). To upload other government-issued identification documents, use the [Submit KYC Documents](https://developers.bitgo.com/reference/entityvalidationidentitydocumentcreate) endpoint instead
    - `nameFirst` string, required — The first name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameLast` string, required — The last name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameMiddle` string — The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `notionalTradedEachMonth` number — The estimated notional amount traded per month in USD
    - `occupation` 'Agriculture' | 'Art Dealer / Auctioneer / Import / Export Company' | 'Financial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-Profit/Foundation/Endowment' | 'Computer Programmer / Administrator / Software Engineer / IT or Software / Technology Company' | 'Crypto Services (ATM, Exchange, Lender, Coins/Token)' | 'Education / Teacher' | 'Extractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious Metals' | 'Family Office' | 'Film / TV / Entertainment (not adult)' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Healthcare' | 'Law Enforcement / Military / Protective Services' | 'Miner / Mining Pool' | 'Money Service Business' | 'Other' | 'Private Equity / Venture Capital' | 'Professional Service Providers (lawyers accountants etc.)' | 'Real estate brokers developers and appraisers' | 'Recreation / Hospitality' | 'Student / Unemployed / Retired' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Other - Default' | 'Weapons Dealers', required
    - `organizationId` string, required — The Bitgo organization ID
    - `phoneNumber` string, required — The phone number of the individual
    - `politicallyExposedPerson` boolean, required — Whether the individual is a Politically Exposed Person (PEP)
    - `transactionType` 'incContracted', required
    - `userId` string, required — The BitGo user ID
  - object
    - `addressCity` string, required — The city of the address
    - `addressPostalCode` string, required — The postal or ZIP code
    - `addressStreet1` string, required — The street address line 1
    - `addressStreet2` string — The street address line 2
    - `cityOfBirth` string, required — The city of birth
    - `countryOfBirth` string, required — The country of birth (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfCitizenship` string, required — The country of citizenship (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfResidence` string, required — The country of residence (ISO Alpha-2 or Alpha-3 country code)
    - `countryOfTaxResidence` string, required — The country of tax residence (ISO Alpha-2 or Alpha-3 country code)
    - `dateOfBirth` object, required — The date of birth of the individual
      - `day` string, DD, required
      - `month` string, MM, required
      - `year` string, YYYY, required
    - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
    - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
    - `email` string, required — The email address of the individual
    - `employmentStatus` 'Civil servant' | 'Employee' | 'Student' | 'Retiree / Pensioner' | 'Public service' | 'Self-employed' | 'Unemployed', required
    - `enterpriseId` string, required — The BitGo enterprise ID
    - `externalUserId` string, required — The external user identifier from the EU CaaS client
    - `govIdCountryOfIssuance` string — The country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code). Required only for EU regulated clients.
    - `govIdExpiry` object — The expiry date of the government-issued ID. Required only for EU regulated clients.
      - `day` string, DD, required
      - `month` string, MM, required
      - `year` string, YYYY, required
    - `govIdNumber` string — The government-issued ID document number. Required only for EU regulated clients.
    - `govIdType` 'pp' | 'ppc' | 'rp' | 'pr' | 'id' — The type of government-issued ID document. Required only for EU regulated clients.
    - `idvPerformed` boolean, required — Whether identity verification has been performed by the EU CaaS client
    - `industry` 'MiCAR/EEA Regulated CASP' | 'Banking & Credit Institutions' | 'Insurance & Pension' | 'Legal, Notary, and Fiduciary Services' | 'Accounting & Audit' | 'Business Consulting & Agency' | 'Software & IT Services' | 'Hardware & Electronics' | 'Telecommunications' | 'Media & Entertainment' | 'Retail & Wholesale Trade' | 'Manufacturing & Industrial' | 'Construction & Infrastructure' | 'Agriculture & Food' | 'Hospitality & Travel' | 'Education & Research' | 'Healthcare & Life Sciences' | 'Employed / Self-Employed' | 'Retired' | 'Non-EEA Regulated VASP' | 'Token Issuers & Web3 Projects' | 'Investment & Asset Mgmt' | 'Brokerage & Trading (Fiat)' | 'Precious Goods Dealers' | 'Energy & Extractives' | 'Real Estate Development & Broking' | 'Trust & Company Service Providers' | 'Transportation & Logistics' | 'Government & Public Admin' | 'Non-Profit / NGO / Charity' | 'Student' | 'Unemployed' | 'Unregulated / Offshore VASP' | 'DeFi / DAO / Unhosted' | 'Mining & Staking Providers' | 'Proprietary Trading / Market Maker' | 'Payment Services & MSBs' | 'Gambling & Gaming' | 'Arms & Defense' | 'Adult & Restricted Entertainment' | 'High-profile Government' | 'High Net Worth (HNWI)', required
    - `initialKycCompletionDate` object, required — The date of initial KYC completion
      - `day` string, DD, required
      - `month` string, MM, required
      - `year` string, YYYY, required
    - `lastKycCompletionDate` object, required — The date of last KYC completion
      - `day` string, DD, required
      - `month` string, MM, required
      - `year` string, YYYY, required
    - `nameFirst` string, required — The first name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameLast` string, required — The last name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `nameMiddle` string — The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)
    - `organizationId` string, required — The Bitgo organization ID
    - `phoneNumber` string — The phone number of the individual. Required only for EU unregulated clients.
    - `politicallyExposedPerson` boolean, required — Whether the individual is a Politically Exposed Person (PEP)
    - `sourceOfFunds` 'Income from Employment' | 'Pension' | 'Income from Renting and Leasing' | 'Income from Self-Employment' | 'Inheritance / Gift' | 'Crypto' | 'Other Financial Support', required
    - `taxId` string, required — The tax identification number
    - `transactionType` 'euIndividual', required — The type of KYC identity being created
    - `userId` string, required — The BitGo user ID

## Response `200`

OK

- IdentityCreateResponse
  - `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`

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[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)