Skip to main content
POST
/
v1
/
identities
Create identity
curl --request POST \
  --url https://api.clearbox.example.com/v1/identities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Ada",
  "last_name": "Lovelace",
  "email": "ada@example.com",
  "date_of_birth": "1990-12-10",
  "address": {
    "line1": "5 Analytical Ave",
    "city": "London",
    "postal_code": "EC1A 1BB",
    "country": "GB"
  }
}
'
{
  "identity_id": "idn_8f2a",
  "kyc_inquiry_id": "inq_9d4f",
  "wallet_address": "0xA1b2C3d4",
  "created_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.clear-box.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

ClearBox API key. Use cb_sandbox_... in the sandbox and cb_live_... in production.

Body

application/json
​
first_name
string
required
​
last_name
string
required
​
email
string<email>
required
​
date_of_birth
string<date>
​
address
object

Response

Identity created.

​
identity_id
string
required
Example:

"idn_8f2a"

​
kyc_status
enum<string>
required
Available options:
pending,
approved,
declined,
needs_review
​
kyc_inquiry_id
string
Example:

"inq_9d4f"

​
wallet_address
string
Example:

"0xA1b2C3d4"

​
created_at
string<date-time>