POST
/
customers
Create a customer
curl --request POST \
  --url https://api.lumx.io/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "individual",
  "name": "William Default",
  "taxId": "123.456.789-00",
  "birthDate": "1990-01-01",
  "country": "BRA",
  "email": "william.default@example.com"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "INDIVIDUAL",
  "name": "William Default",
  "taxId": "123.456.789-00",
  "birthDate": "1990-01-01",
  "country": "BRA",
  "email": "william.default@example.com",
  "walletAddress": "0x1234567890123456789012345678901234567890",
  "blockExplorerUrl": "https://amoy.polygonscan.com/address/0x1234567890123456789012345678901234567890",
  "verification": {
    "status": "NOT_STARTED",
    "level": "STANDARD",
    "link": "https://in.sumsub.com/websdk/p/sbx_aA00bB11cC33dD44"
  },
  "transactionLimits": {
    "single": "1000.00",
    "daily": "10000.00",
    "monthly": "100000.00"
  },
  "createdAt": "2021-01-01T00:00:00Z",
  "updatedAt": "2021-01-01T00:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header on the format Bearer <API_KEY>.

Body

application/json

Customer type is individual.

​
type
enum<string>
required

Customer's type.

Available options:
individual
Example:

"individual"

​
name
string
required

Customer's full name.

Example:

"William Default"

​
taxId
string
required

Customer's tax ID. It must be a valid tax ID in the country where the customer lives.

Example:

"123.456.789-00"

​
birthDate
string<date>
required

Customer's birth date.

Example:

"1990-01-01"

​
country
enum<string>
required

Customer's country using ISO 3166-1 alpha-3 code.

Available options:
BRA
Example:

"BRA"

​
email
string
required

Customer's email.

Example:

"william.default@example.com"

Response

201 - application/json

Resource successfully created.

Customer type is individual.

​
id
string<uuid>

Customer's unique identifier.

​
taxId
string

Customer's tax ID. It must be a valid tax ID in the country where the customer lives.

Example:

"123.456.789-00"

​
walletAddress
string

Customer's wallet address.

Example:

"0x1234567890123456789012345678901234567890"

​
blockExplorerUrl
string

Customer's block explorer URL.

Example:

"https://amoy.polygonscan.com/address/0x1234567890123456789012345678901234567890"

​
verification
object

Customer's verification KYC/KYB.

​
transactionLimits
object

Verification's transaction limits.

​
createdAt
string<date-time>

Creation date and time (UTC).

Example:

"2021-01-01T00:00:00Z"

​
updatedAt
string<date-time>

Last update date and time (UTC).

Example:

"2021-01-01T00:00:00Z"

​
type
enum<string>

Customer's type.

Available options:
individual
Example:

"individual"

​
name
string

Customer's full name.

Example:

"William Default"

​
birthDate
string<date>

Customer's birth date.

Example:

"1990-01-01"

​
country
enum<string>

Customer's country using ISO 3166-1 alpha-3 code.

Available options:
BRA
Example:

"BRA"

​
email
string

Customer's email.

Example:

"william.default@example.com"