API References

Create KYC Identity

post
https://app.bitgo-test.com/api/evs/v1/identity

Create a KYC identity for a user.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≥ 1

The city of residence

string
length ≥ 1

The postal or ZIP code

string
required
length ≥ 1

The street address line 1

string
length ≥ 1

The street address line 2

string
required
length ≥ 1

The state, province, or region of residence

date
required

The birthdate of the individual (YYYY-MM-DD)

string
required
length ≥ 1

The country of the address (ISO Alpha-2 or Alpha-3 country code)

string
required
length ≥ 1

The country of citizenship (ISO Alpha-2 or Alpha-3 country code)

string
required
length ≥ 1

The country of residence (ISO Alpha-2 or Alpha-3 country code)

string
length ≥ 1

Debug failure reason to provide additional context when simulating verification failure in the test environment

string
enum

Debug status for simulating verification failure or success in the test environment - passes by default

Allowed:
string
length ≥ 1

A digital asset wallet address of the individual where funds will be deposited from

string
required
length ≥ 1

The BitGo enterprise ID

string
required
length ≥ 1

The country of issuance of the government ID (ISO Alpha-2 or Alpha-3 country code)

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 endpoint instead
string
required

The first name (Latin letters, spaces, hyphens, apostrophes, and periods)

string
required

The last name (Latin letters, spaces, hyphens, apostrophes, and periods)

string

The middle name (Latin letters, spaces, hyphens, apostrophes, and periods)

number

The estimated notional amount traded per month in USD

string
enum
required

The occupation category of the individual

string
required
length ≥ 1

The Bitgo organization ID

string
required
length ≥ 1

The phone number of the individual

boolean
required

Whether the individual is a Politically Exposed Person (PEP)

string
enum
required

The type of KYC identity being created

Allowed:
string
required
length ≥ 1

The BitGo user ID

Responses

Updated 2 months ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago