Skip to main content
GET
/
v1
/
businesses
/
{businessId}
/
kyb
Get KYB for a business
curl --request GET \
  --url https://api.cadanapay.com/v1/businesses/{businessId}/kyb \
  --header 'Authorization: Bearer <token>'
{
  "id": "d4475c70-d759-495e-a052-3e3a1cba1857",
  "tenantKey": "cad62002887",
  "entityName": "Airtel",
  "entityType": "corporation",
  "taxIdentificationNumber": "NN-528343998",
  "incorporation": {
    "date": "2025-01-01T00:00:00.000Z",
    "address": {
      "countryCode": "US",
      "line1": "Street 1",
      "line2": "Apt 1",
      "city": "Gotham",
      "postalCode": "10001",
      "state": "NY"
    }
  },
  "phoneNumber": {
    "countryCode": "1",
    "number": "2345678901"
  },
  "email": "jsmith@example.com",
  "websiteURL": "",
  "natureOfBusiness": "Software Development",
  "sizeOfCompany": "300-400",
  "sourceOfFunds": "Personal Savings",
  "status": "pending-review",
  "annualRevenue": {
    "currency": "USD",
    "min": 100000,
    "max": 1000000
  },
  "expectedMonthlyTransactionVolume": {
    "currency": "USD",
    "min": 50000,
    "max": 80000
  },
  "address": {
    "countryCode": "US",
    "line1": "Street 1",
    "line2": "Apt 1",
    "city": "Gotham",
    "postalCode": "10001",
    "state": "NY"
  },
  "documents": {
    "articlesOfIncorporation": [
      "<string>"
    ],
    "bankStatements": [
      "<string>"
    ],
    "proofOfAddress": [
      "<string>"
    ],
    "taxDocuments": [
      "<string>"
    ]
  },
  "principals": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "ownershipPercentage": 0.5,
      "email": "jsmith@example.com",
      "phoneNumber": {
        "countryCode": "1",
        "number": "2345678901"
      },
      "address": {
        "countryCode": "US",
        "line1": "Street 1",
        "line2": "Apt 1",
        "city": "Gotham",
        "postalCode": "10001",
        "state": "NY"
      },
      "isExecutive": false,
      "title": "",
      "id": "f116c829-3c93-4d24-880d-3a00faf784a2",
      "identifier": {
        "type": "passport",
        "value": "1234567890"
      }
    }
  ],
  "requirements": {
    "currentlyDue": [
      "principals.0.phoneNumber.countryCode",
      "phoneNumber.countryCode",
      "principals.0.address.state",
      "email",
      "entityName"
    ],
    "errors": [
      {
        "field": "entityName",
        "reason": "Only english letters are allowed"
      }
    ]
  }
}

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

Response

get KYB response

id
string<uuid>

KYB record ID

Example:

"d4475c70-d759-495e-a052-3e3a1cba1857"

tenantKey
string

Tenant key

Example:

"cad62002887"

entityName
string

Business name

Example:

"Airtel"

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

email
string<email>

Business email address

websiteURL
string<uri>

Business website URL

Example:

""

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"

status
enum<string>

KYB status

Available options:
initialized,
needs-additional-info,
pending-review,
incomplete,
complete
Example:

"pending-review"

annualRevenue
object

Annual revenue range

expectedMonthlyTransactionVolume
object

Expected monthly transaction volume range

address
object

Address

documents
object

Document file URLs

principals
object[]

Principals associated with the business

requirements
object

KYB requirements and validation status