Skip to main content
POST
/
v1
/
businesses
/
{businessId}
/
kyb
Submit KYB
curl --request POST \
  --url https://api.cadanapay.com/v1/businesses/{businessId}/kyb \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityName": "Tesla",
  "entityType": "corporation",
  "taxIdentificationNumber": "NN-528343998",
  "incorporation": {
    "date": "2025-01-01"
  },
  "phoneNumber": {
    "countryCode": "1",
    "number": "2345678901"
  },
  "websiteURL": "https://www.tesla.com",
  "natureOfBusiness": "Software Development",
  "sizeOfCompany": "300-400",
  "sourceOfFunds": "Personal Savings",
  "annualRevenue": {
    "currency": "USD",
    "min": 100000,
    "max": 1000000
  },
  "expectedMonthlyTransactionVolume": {
    "currency": "USD",
    "min": 50000,
    "max": 80000
  },
  "principals": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "ownershipPercentage": 0.5,
      "email": "john.doe@example.com",
      "phoneNumber": {
        "countryCode": "1",
        "number": "2345678901"
      },
      "isExecutive": true,
      "title": "CEO",
      "dateOfBirth": "1990-01-15",
      "identifier": {
        "type": "passport",
        "value": "1234567890",
        "identityFileId": "file-id-123",
        "identityBackPageFileId": "file-id-124",
        "addressFileId": "file-id-125"
      }
    }
  ],
  "articlesOfIncorporation": [
    "file-id-001",
    "file-id-002"
  ],
  "bankStatements": [
    "file-id-003",
    "file-id-004"
  ],
  "proofOfAddress": [
    "file-id-005"
  ],
  "taxDocuments": [
    "file-id-006",
    "file-id-007"
  ]
}
'
{
  "code": "invalid_request_body",
  "message": "The request body provided is not valid",
  "params": {
    "field": "Value is invalid."
  }
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
X-MultiTenantKey
string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Path Parameters

​
businessId
string
required

The unique identifier for the business

Body

application/json
​
entityName
string

Business name

Example:

"Tesla"

​
entityType
enum<string>

Type of entity

Available options:
corporation,
c-corporation,
s-corporation,
partnership,
sole proprietorship,
limited liability company,
non profit,
other
Example:

"corporation"

​
taxIdentificationNumber
string

Tax identification number

Example:

"NN-528343998"

​
incorporation
object

Incorporation details

​
phoneNumber
object

Person's phone number

​
websiteURL
string<uri>

Business website URL

Example:

"https://www.tesla.com"

​
natureOfBusiness
string

Description of the primary business activities and industry

Example:

"Software Development"

​
sizeOfCompany
string

Size of the company

Example:

"300-400"

​
sourceOfFunds
string

Source of funds

Example:

"Personal Savings"

​
annualRevenue
object

Annual revenue range

​
expectedMonthlyTransactionVolume
object

Expected monthly transaction volume range

​
address
object

Address

​
principals
object[]

Principals are individuals with ownership shares of 25% or more

​
articlesOfIncorporation
string<uuid>[]

File IDs for articles of incorporation documents

Example:
["file-id-001", "file-id-002"]
​
bankStatements
string<uuid>[]

File IDs for bank statements

Example:
["file-id-003", "file-id-004"]
​
proofOfAddress
string<uuid>[]

File IDs for proof of address documents

Example:
["file-id-005"]
​
taxDocuments
string<uuid>[]

File IDs for tax documents

Example:
["file-id-006", "file-id-007"]

Response

KYB information submitted successfully