Cadana KYB Requirements

Cadana requires the following information to verify a business (“KYB”) and its principals (“KYC”). Automated verification is performed using gov databases. If verification cannot be completed automatically, supporting documents must be uploaded.

Endpoint:

Full API docs: Submit KYB

1. Business Requirements

Requirement	API Field	Verification Rules
Legal business name	`name`	Must match state registration.
Business address	`address.line1, address.city, address.state, address.postalCode, address.countryCode`	Must be a valid physical address; PO Boxes not allowed.
Phone number	`phone.countryCode, phone.number`	Must be a reachable business phone.
EIN / Tax ID	`taxId`	Must be a valid IRS-issued EIN.
Company registration number	`companyRegistrationNumber`	Must match Secretary of State / corporate registry.
State of incorporation	`stateOfIncorporation`	Must match corporate records.
Jurisdiction of headquarters	`jurisdictionOfHeadquarters`	Must be a valid jurisdiction.
Year established	`yearEstablished`	Must be a valid year.
Business structure	`typeOfCorporation`	LLC, Corporation, Partnership, Sole Prop, etc.
Company size (revenue)	`companySize`	Informational
Employee count	`employeeNumber`	Informational

2. Principal / UBO Requirements

You must provide information for individuals who:

own ≥25% of the business (ownershipPercentage ≥ 25), or
hold significant managerial responsibility (isExecutive = true)
atleast one executive/representative is required to complete KYB

Requirement	API Field	Verification Rules
Full legal name	`principals[].name`	Must match ID document.
Date of birth	`principals[].dateOfBirth`	Must be valid and ≥18 years old.
Email	`principals[].email`	Must be a valid email of the person.
Phone number	`principals[].phone.countryCode, principals[].phone.number`	Must be a reachable phone.
Residential address	`principals[].address.line1, principals[].address.city, principals[].address.state, principals[].address.postalCode, principals[].address.countryCode`	Must be a physical residential address; PO Boxes not allowed.
SSN (US persons)	`principals[].ssn`	Must be a valid SSN.
ID Number (Non-US persons)	`principals[].idNumber`	Must be a valid ID number. KYC Front ID and back ID is required for when is provided.
Ownership %	`principals[].ownershipPercentage`	Required if the individual is an owner. Must be 0–100.
Executive flag	`principals[].isExecutive`	Required for the control person.
Executive Title	`principals[].title`	Required for the control person.
ID document (front)	`principals[].kycFrontFileId`	Required if identity cannot be verified via SSN.
ID document (back)	`principals[].kycBackFileId`	Required if identity cannot be verified via SSN.
Address proof	`principals[].addressProofFileId`	Required if residential address cannot be verified.

3. Required Document Uploads (Conditional)

Document Type	API Field	Trigger
IRS EIN confirmation letter (SS-4 or 147C)	`irsFormFileId`	EIN mismatch or unverified tax ID.
Articles of Incorporation / Certificate of Formation	`incorporationDocumentFileId`	Business registration mismatch.
Proof of business address	`businessAddressProofFileId`	Business address cannot be verified.
Principal ID (front/back)	`principals[].kycFrontFileId`, `principals[].kycBackFileId`	KYC cannot be completed using SSN.
Principal address proof	`principals[].addressProofFileId`	Principal address cannot be verified.

4. Verification Logic

Business Verification

Cadana must verify:

EIN is valid
Business exists and is active
Business address is accurate
No sanctions, fraud, or watchlist hits

If any field fails → document upload required.

Principal / UBO Verification

Cadana must verify:

Identity (name, DOB, SSN)
Address match (automated DB + address proof if needed)
Ownership or executive role
No sanctions/AML flags

If SSN-based verification fails → ID document required.
If address verification fails → address proof required.

5. Example KYB Submission

{
  "name": "ABC Company",
  "address": {
    "line1": "123 Main Street",
    "city": "Anytown",
    "state": "NY",
    "postalCode": "12345",
    "countryCode": "US"
  },
  "phone": {
    "countryCode": "1",
    "number": "2345678901"
  },
  "taxId": "0987654321",
  "companyRegistrationNumber": "1234567890",
  "stateOfIncorporation": "NY",
  "jurisdictionOfHeadquarters": "NY",
  "yearEstablished": 2000,
  "typeOfCorporation": "LLC",
  "companySize": "$10 - 100M",
  "employeeNumber": 1000,
  "principals": [
    {
      "name": "John Doe",
      "email" : "[email protected]",
      "dateOfBirth": "2000-06-24",
      "ssn": "123-45-6789",
      "ownershipPercentage": 60,
      "isExecutive": true,
      "title" : "CEO",
      "address": {
        "line1": "123 Main Street",
        "city": "Anytown",
        "state": "NY",
        "postalCode": "12345",
        "countryCode": "US"
      },
      "kycFrontFileId": "front-id-file-id",
      "kycBackFileId": "back-id-file-id",
      "addressProofFileId": "address-proof-file-id"
    }
  ]
}

6. Document Upload Scenarios

Failed EIN Check

Upload:

irsFormFileId → SS-4 or 147C (must show exact legal name + EIN)

Failed Business Address Verification

Upload:

businessAddressProofFileId → utility bill, lease, or bank statement

Failed Principal Identity Verification

Upload:

principals[].kycFrontFileId and principals[].kycBackFileId

Failed Principal Address Verification

Upload:

principals[].addressProofFileId