Ctrl+K

Create KYC Identity V2

post/api/evs/v2/identity

Marks a user identity as scheduled to be created later by the identity creation worker.

Request Body

One of
addressCity string required
Min length: >= 1 characters
addressPostalCode string
Min length: >= 1 characters
addressStreet1 string required
Min length: >= 1 characters
addressStreet2 string
Min length: >= 1 characters
addressSubdivision string required
Min length: >= 1 characters
birthdate string <date>required
The birthdate of the individual (YYYY-MM-DD)
Example: 2000-12-25T00:00:00.000Z
country string required
The country of the address (ISO Alpha-2 or Alpha-3 country code)
Min length: >= 1 characters
Example: US
countryOfCitizenship string required
The country of citizenship (ISO Alpha-2 or Alpha-3 country code)
Min length: >= 1 characters
Example: US
countryOfResidence string required
The country of residence (ISO Alpha-2 or Alpha-3 country code)
Min length: >= 1 characters
Example: US
debugFailureReason string
Debug failure reason to provide additional context when simulating verification failure in the test environment
Min length: >= 1 characters
debugStatus string
Debug status for simulating verification failure or success in the test environment - passes by default
Allowed values: passed failed
digitalAssetWalletAddress string
A digital asset wallet address of the individual where funds will be deposited from
Min length: >= 1 characters
enterpriseId string required
Min length: >= 1 characters
govIdCountryOfIssuance string required
The country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code)
Min length: >= 1 characters
Example: US
identificationNumber string
Min length: >= 1 characters
nameFirst string required
nameLast string required
nameMiddle string
notionalTradedEachMonth number
occupation string required
Allowed values: 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
organizationId string required
Min length: >= 1 characters
phoneNumber string required
Min length: >= 1 characters
politicallyExposedPerson boolean required
transactionType string required
Allowed value: institutionalIndividual
userId string required
Min length: >= 1 characters

200 Response

id string required
status string required
The status of the KYC identity: `initiating`, `awaiting document upload`, `input error`, `ssn error`, `in review`, `incomplete verifications`, `awaiting signature`, `records uploaded`, `approved`, `declined`
Min length: >= 1 characters

400 Response

name string
context object required
status number
additionalDetails object
retryAfter number required
error string required
requestId string required

401 Response

name string
context object required
status number
additionalDetails object
retryAfter number required
error string required
requestId string required

403 Response

name string
context object required
status number
additionalDetails object
retryAfter number required
error string required
requestId string required