Skip to main content
POST
/
v2
/
kyc
/
new-level-1
/
api
Submit level-1 KYC/KYB via API
curl --request POST \
  --url https://api.example.com/v2/kyc/new-level-1/api \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fullName": "<string>",
  "dateOfBirth": "<string>",
  "countryOfTaxId": "<string>",
  "taxIdNumber": "<string>",
  "email": "jsmith@example.com",
  "sandboxReject": true,
  "phone": "<string>",
  "uploadedSelfieId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "uploadedDocumentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "country": "<string>",
  "state": "<string>",
  "city": "<string>",
  "zipCode": "<string>",
  "streetAddress": "<string>",
  "lang": "<string>",
  "emailPixKey": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

​
Submit level-1 KYC/KYB via API

POST request to /v2/kyc/new-level-1/api

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
subAccountId
string<uuid>

Operate against a sub-account of the authenticated main account.

Body

application/json

Request body shape depends on the authenticated account type. Submit the individual shape for INDIVIDUAL accounts and the company shape for COMPANY accounts.

Request body shape depends on the authenticated account type. The server determines the type from the auth context and rejects payloads that do not match.

​
fullName
string
required
​
dateOfBirth
string
required
​
countryOfTaxId
string
required
​
taxIdNumber
string
required
​
email
string<email>
required
​
sandboxReject
boolean
​
phone
string
​
uploadedSelfieId
string<uuid>
​
uploadedDocumentId
string<uuid>
​
country
string
​
state
string
​
city
string
​
zipCode
string
​
streetAddress
string
​
lang
string
​
emailPixKey
string

Response

KYC attempt created.

Attempt identifier returned by both INDIVIDUAL and COMPANY flows.

​
id
string<uuid>
required

The created KYC attempt identifier.