Sign in
public.customers

Submit Business Verification

Compatibility route for submitting tier 2 business KYB information for an existing customer. Prefer /v1/customers/{id}/tier2-verification with customer_type=business for new integrations.

post/v1/customers/{id}/business-verification

Path parameters

idstring required

Customer ID (UUID format)

Request body

account_purposestring required
account_purpose_otherstring
business_descriptionstring required
business_industrystring[]
business_legal_namestring required
business_typestring required
conducts_money_servicesboolean required
conducts_money_services_descriptionstring
conducts_money_services_using_bridgeboolean
customer_type'business'
estimated_annual_revenue_usdstring required
expected_monthly_payments_usdstring required
has_material_intermediary_ownershipboolean
high_risk_activitiesstring[]
high_risk_activities_explanationstring
is_daoboolean required
operates_in_prohibited_countriesboolean required
other_websitesstring[]
ownership_thresholdinteger
primary_websitestring
source_of_fundsstring required
source_of_funds_descriptionstring

Example request

{
  "account_purpose": "operating_a_company",
  "associated_persons": [
    {
      "birth_date": "1990-05-15",
      "documents": [
        {
          "file": "data:image/png;base64,iVBORw0KGgo...",
          "purposes": [
            "proof_of_address"
          ]
        }
      ],
      "email": "jane@example.com",
      "first_name": "Jane",
      "has_control": true,
      "has_ownership": true,
      "identifying_information": [
        {
          "expiration": "2030-01-01",
          "image_back": "data:image/png;base64,iVBORw0KGgo...",
          "image_front": "data:image/png;base64,iVBORw0KGgo...",
          "issuing_country": "NGA",
          "number": "A12345678",
          "type": "passport"
        }
      ],
      "is_director": true,
      "is_signer": true,
      "last_name": "Doe",
      "nationality": "GBR",
      "ownership_percentage": 50,
      "relationship_established_at": "2020-01-01",
      "residential_address": {
        "city": "Lagos",
        "country": "NGA",
        "postal_code": "100001",
        "street_line_1": "123 Main St",
        "subdivision": "LA"
      },
      "title": "Director"
    }
  ],
  "business_description": "Cross-border collection and treasury operations",
  "business_legal_name": "Ada Labs Ltd",
  "business_type": "corporation",
  "customer_type": "business",
  "documents": [
    {
      "file": "data:image/png;base64,iVBORw0KGgo...",
      "purposes": [
        "proof_of_address"
      ]
    }
  ],
  "estimated_annual_revenue_usd": "1000000_4999999",
  "expected_monthly_payments_usd": "50000_plus",
  "identifying_information": [
    {
      "expiration": "2030-01-01",
      "image_back": "data:image/png;base64,iVBORw0KGgo...",
      "image_front": "data:image/png;base64,iVBORw0KGgo...",
      "issuing_country": "NGA",
      "number": "A12345678",
      "type": "passport"
    }
  ],
  "ownership_threshold": 25,
  "physical_address": {
    "city": "Lagos",
    "country": "NGA",
    "postal_code": "100001",
    "street_line_1": "123 Main St",
    "subdivision": "LA"
  },
  "primary_website": "https://example.com",
  "registered_address": {
    "city": "Lagos",
    "country": "NGA",
    "postal_code": "100001",
    "street_line_1": "123 Main St",
    "subdivision": "LA"
  },
  "source_of_funds": "company_funds"
}

Response

OK

created_atstring
emailstring
first_namestring
idstring
is_verifiedboolean
last_namestring
rejection_reasonsstring[]

RejectionReasons contains the current blocking verification/capability issues. It is empty after approval.

tier_1_kyc_completeboolean
tier_2_kyc_completeboolean
updated_atstring

Example response

{
  "capabilities": [
    {
      "name": "base",
      "status": "approved"
    }
  ],
  "created_at": "2025-01-05T15:04:05Z",
  "email": "customer@example.com",
  "first_name": "John",
  "id": "650e8400-e29b-41d4-a716-446655440000",
  "last_name": "Doe",
  "paystack_funding_account_readiness": {
    "account_number_last4": "6789",
    "bank_code": "058",
    "status": "READY",
    "updated_at": "2026-08-10T12:00:00Z"
  },
  "updated_at": "2025-01-05T15:04:05Z"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.