---
title: "Update KYC Identity"
method: PATCH
path: "/api/evs/v1/identity/{id}"
tags: ["Know Your Customer (KYC)"]
---

# Update KYC Identity

`PATCH /api/evs/v1/identity/{id}`

Update an existing KYC identity with new information.

## Path parameters

- `id` string, required

## Request body

- object
  - `enterpriseId` string — The BitGo enterprise ID
  - `userId` string — The BitGo user ID
  - `organizationId` string — The Bitgo organization ID
  - `nameFirst` string — The first name
  - `nameLast` string — The last name
  - `nameMiddle` string — The middle name
  - `debugStatus` 'passed' | 'failed' — Debug status for simulating verification failure or success in the test environment - passes by default
  - `debugFailureReason` string — Debug failure reason to provide additional context when simulating verification failure in the test environment
  - `contractSignerNameFull` string — The full name of the individual signing the contract
  - `contractSignedDate` string, date — The date the contract was signed (YYYY-MM-DD)
  - `contractSignedIPAddress` string — The IP address from which the contract was signed
  - `contractVersion` string — The version of the contract being signed
  - `userAgreesToTerms` boolean — Whether the user agrees to the terms and conditions
  - `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' — The occupation category of the individual
  - `annualIncome` 'Under $50,000' | '$50,001 - $100,000' | '$100,001 - $300,000' | '$300,001 - $500,000' | '$500,001 and over' — The annual income range of the individual
  - `netWorth` 'Under $100,000' | '$100,001 - $500,000' | '$500,001 - $1,000,000' | '$1,000,001 - $5,000,000' | '$5,000,001 and over' — The net worth range of the individual
  - `sourceOfNetWorth` 'Employment Income: Includes salaries, wages, and bonuses.' | 'Business Income: Revenue from self-owned businesses or proceeds from the sale of a business.' | 'Legal and Compensation Payments: Funds received from legal settlements, including insurance claims, divorce settlements, accident compensations, etc.' | 'Inheritances and Gifts: Money or assets received as an inheritance, gift, or through trust distributions.' | 'Investment Earnings: Profits derived from investments such as cryptocurrencies, stocks, bonds, private equity, or venture capital.' — The primary source of the individual's net worth
  - `initialDepositType` 'Fiat Currency' | 'Crypto / Digital Assets' — The type of initial deposit being made
  - `expectedMonthlyDeposits` '0-10 Transactions' | '11-20 Transactions' | '21+ Transactions' — The expected monthly deposit amount range
  - `expectedMonthlyWithdrawals` '0-10 Transactions' | '11-20 Transactions' | '21+ Transactions' — The expected monthly withdrawal amount range
  - `phoneNumber` string — The phone number of the individual. Required for EU unregulated clients.
  - `birthdate` string, date — The birthdate of the individual (YYYY-MM-DD)
  - `countryOfCitizenship` string — The country of citizenship (ISO Alpha-2 or Alpha-3 country code)
  - `countryOfResidence` string — The country of residence (ISO Alpha-2 or Alpha-3 country code)
  - `govIdCountryOfIssuance` string — The country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code)
  - `politicallyExposedPerson` boolean — Whether the individual is a Politically Exposed Person (PEP)
  - `addressStreet1` string — The street address line 1
  - `addressCity` string — The city of residence
  - `addressSubdivision` string — The state, province, or region of residence
  - `country` string — The country of the address (ISO Alpha-2 or Alpha-3 country code)
  - `identificationNumber` string — Tax identification number for US individuals (SSN or ITIN). Required for US citizens (SSN) and US residents (SSN or ITIN). Non-US individuals may optionally submit SSN or ITIN if held (e.g. dual nationals, former US residents). For other identification documents (e.g., passport, driver's license), use the [Submit KYC Documents](https://developers.bitgo.com/reference/entityvalidationidentitydocumentcreate) endpoint after creating the KYC identity
  - `addressStreet2` string — The street address line 2
  - `addressPostalCode` string — The postal or ZIP code
  - `digitalAssetWalletAddress` string — A digital asset wallet address of the individual where funds will be deposited from
  - `notionalTradedEachMonth` number — The estimated notional amount traded per month in USD
  - `isEntity` boolean — True, if the account represents a business entity. False, if the account represents an individual
  - `enterpriseName` string — The legal name of the individual or entity
  - `countryOfIncorporation` string — The country of incorporation (ISO Alpha-2 or Alpha-3 country code)
  - `dateOfIncorporation` string, date — The date of incorporation (YYYY-MM-DD)
  - `dateOfBirth` object — The date of birth of the individual
    - `day` string, DD, required
    - `month` string, MM, required
    - `year` string, YYYY, required
  - `taxId` string — The tax identification number
  - `idvPerformed` boolean — Whether identity verification has been performed by the EU CaaS client

## Response `200`

OK

- IdentityUpdateResponse
  - `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, required
  - `enterpriseId` string
  - `userId` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `errorDescription` 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)