PATCH
Update KYC Identity
Update an existing KYC identity with new information.
Path Params
-
idstring required
Body Params
object
-
enterpriseIdstringThe BitGo enterprise ID -
userIdstringThe BitGo user ID -
organizationIdstringThe Bitgo organization ID -
nameFirststringThe first name -
nameLaststringThe last name -
nameMiddlestringThe middle name -
debugStatusstring enumDebug status for simulating verification failure or success in the test environment - passes by defaultpassedfailed -
debugFailureReasonstringDebug failure reason to provide additional context when simulating verification failure in the test environment -
contractSignerNameFullstringThe full name of the individual signing the contract -
contractSignedDatestring dateThe date the contract was signed (YYYY-MM-DD) -
contractSignedIPAddressstringThe IP address from which the contract was signed -
contractVersionstringThe version of the contract being signed -
userAgreesToTermsbooleanWhether the user agrees to the terms and conditions -
occupationstring enumThe occupation category of the individualAgricultureArt Dealer / Auctioneer / Import / Export CompanyFinancial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)Casinos and Gambling EstablishmentsCharity/NGO/Non-Profit/Foundation/EndowmentComputer Programmer / Administrator / Software Engineer / IT or Software / Technology CompanyCrypto Services (ATM, Exchange, Lender, Coins/Token)Education / TeacherExtractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious MetalsFamily OfficeFilm / TV / Entertainment (not adult)Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)HealthcareLaw Enforcement / Military / Protective ServicesMiner / Mining PoolMoney Service BusinessOtherPrivate Equity / Venture CapitalProfessional Service Providers (lawyers accountants etc.)Real estate brokers developers and appraisersRecreation / HospitalityStudent / Unemployed / RetiredTraders / Trading (High Frequency, Proprietary, Market Maker)Other - DefaultWeapons Dealers -
annualIncomestring enumThe annual income range of the individualUnder $50,000$50,001 - $100,000$100,001 - $300,000$300,001 - $500,000$500,001 and over -
netWorthstring enumThe net worth range of the individualUnder $100,000$100,001 - $500,000$500,001 - $1,000,000$1,000,001 - $5,000,000$5,000,001 and over -
sourceOfNetWorthstring enumThe primary source of the individual's net worthEmployment 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. -
initialDepositTypestring enumThe type of initial deposit being madeFiat CurrencyCrypto / Digital Assets -
expectedMonthlyDepositsstring enumThe expected monthly deposit amount range0-10 Transactions11-20 Transactions21+ Transactions -
expectedMonthlyWithdrawalsstring enumThe expected monthly withdrawal amount range0-10 Transactions11-20 Transactions21+ Transactions -
phoneNumberstringThe phone number of the individual. Required for EU unregulated clients. -
birthdatestring dateThe birthdate of the individual (YYYY-MM-DD) -
countryOfCitizenshipstringThe country of citizenship (ISO Alpha-2 or Alpha-3 country code) -
countryOfResidencestringThe country of residence (ISO Alpha-2 or Alpha-3 country code) -
govIdCountryOfIssuancestringThe country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code) -
politicallyExposedPersonbooleanWhether the individual is a Politically Exposed Person (PEP) -
addressStreet1stringThe street address line 1 -
addressCitystringThe city of residence -
addressSubdivisionstringThe state, province, or region of residence -
countrystringThe country of the address (ISO Alpha-2 or Alpha-3 country code) -
identificationNumberobjectTax 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 endpoint after creating the KYC identity
-
addressStreet2stringThe street address line 2 -
addressPostalCodestringThe postal or ZIP code -
digitalAssetWalletAddressstringA digital asset wallet address of the individual where funds will be deposited from -
notionalTradedEachMonthnumberThe estimated notional amount traded per month in USD -
isEntitybooleanTrue, if the account represents a business entity. False, if the account represents an individual -
enterpriseNamestringThe legal name of the individual or entity -
countryOfIncorporationstringThe country of incorporation (ISO Alpha-2 or Alpha-3 country code) -
dateOfIncorporationstring dateThe date of incorporation (YYYY-MM-DD) -
dateOfBirthobjectThe date of birth of the individualdateOfBirth object
-
daystring DD required -
monthstring MM required -
yearstring YYYY required
-
-
taxIdstringThe tax identification number -
idvPerformedbooleanWhether identity verification has been performed by the EU CaaS client
Responses
200
OK
Response Body
object
-
idstring required -
statusstring requiredThe 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 -
organizationIdstring required -
enterpriseIdstring -
userIdstring -
createdAtstring date-time -
updatedAtstring date-time -
errorDescriptionstring -
signaturesSubmittedarray of string enumscsampamicwvraca -
signaturesRequiredarray of string enumscsampamicwvraca
400
Bad Request
Response Body
object
-
namestring -
contextmap of objects requiredcontext object
-
<key>object
-
-
statusnumber -
additionalDetailsobjectadditionalDetails object
-
retryAfternumber required
-
-
errorstring required -
requestIdstring required
401
Unauthorized
Response Body
object
-
namestring -
contextmap of objects requiredcontext object
-
<key>object
-
-
statusnumber -
additionalDetailsobjectadditionalDetails object
-
retryAfternumber required
-
-
errorstring required -
requestIdstring required
403
Forbidden
Response Body
object
-
namestring -
contextmap of objects requiredcontext object
-
<key>object
-
-
statusnumber -
additionalDetailsobjectadditionalDetails object
-
retryAfternumber required
-
-
errorstring required -
requestIdstring required
404
Not Found
Response Body
object
-
namestring -
contextmap of objects requiredcontext object
-
<key>object
-
-
statusnumber -
additionalDetailsobjectadditionalDetails object
-
retryAfternumber required
-
-
errorstring required -
requestIdstring required