Skip to main content
Submit KYB (Know Your Business) data for a business customer. The customer must already exist with customer_type: "business". 
POST https://kyc.yativo.com/api/business-kyc/submit
This endpoint is on the KYC platform (https://kyc.yativo.com). Requires Idempotency-Key header.

​
Business identity fields

​
customer_id
string
required
The customer UUID from POST /customer.
​
type
string
required
Must be "business".
​
business_legal_name
string
required
The official registered legal name of the business.
​
business_description
string
required
Description of what the business does.
​
email
string
required
Business contact email address.
​
business_type
string
required
One of: "cooperative", "corporation", "llc", "partnership", "sole_prop", "trust", "other".
​
registration_number
string
required
Official government registration or incorporation number.
​
incorporation_date
string
required
Date of incorporation in ISO 8601 format (e.g. "2015-06-15").
​
business_trade_name
string
Trade name or DBA (optional).
​
tax_id
string
Business tax identification number (optional).
​
statement_descriptor
string
How the business name appears on customer statements (optional).
​
phone_calling_code
string
Country calling code for business phone (optional).
​
phone_number
string
Business phone number (optional).
​
business_industry
string
Industry category (optional).
​
primary_website
string
Business website URL (optional).
​
is_dao
boolean
Whether the business is a DAO (optional).
​
has_material_intermediary_ownership
boolean
Whether there is material intermediary ownership (optional).

​
Business addresses

​
registered_address
object
required
The official registered address of the business.
​
physical_address
object
required
The physical operating address of the business.

​
Associated persons

​
associated_persons
array
required
Minimum 1 associated person (beneficial owner, director, or signer).

​
Financial information

​
account_purpose
string
required
Purpose of the business account.
​
source_of_funds
string
required
Source of business funds.
​
estimated_annual_revenue_usd
string
required
Estimated annual revenue range, e.g. "LessThan100K", "100KTo1M", "MoreThan1M".
​
expected_monthly_payments_usd
string
required
Expected monthly payment volume: "LessThan5K", "5KTo50K", or "MoreThan50K".
​
high_risk_activities
array
required
Array of high-risk activity strings the business is involved in (can be empty).
​
high_risk_activities_explanation
string
Explanation of any high-risk activities listed above.

​
Business documents

​
documents
array
required
Minimum 1 business document required.

​
Optional fields

​
identifying_information
array
Business-level identifying documents (optional).
​
extra_documents
array
Additional supporting documents (optional).
​
extra_business_info
object
Additional business information (optional).
​
collections_data
object
Collections configuration data (optional).
​
payouts_data
object
Payouts configuration data (optional).
curl -X POST 'https://kyc.yativo.com/api/business-kyc/submit' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: kyb-acme-corp-2026' \
  -d '{
    "customer_id": "d47f8a2b-1c3e-4f5a-9b8c-7d6e5f4a3b2c",
    "type": "business",
    "business_legal_name": "Acme Corporation LLC",
    "business_description": "International payment processing services",
    "email": "compliance@acme.com",
    "business_type": "llc",
    "registration_number": "LLC-2015-987654",
    "incorporation_date": "2015-06-15",
    "tax_id": "47-1234567",
    "primary_website": "https://acme.com",
    "registered_address": {
      "street_line_1": "100 Corporate Blvd",
      "city": "Miami",
      "state": "FL",
      "postal_code": "33101",
      "country": "US"
    },
    "physical_address": {
      "street_line_1": "100 Corporate Blvd",
      "city": "Miami",
      "state": "FL",
      "postal_code": "33101",
      "country": "US",
      "proof_of_address_file": "https://example.com/docs/office-lease.pdf"
    },
    "associated_persons": [
      {
        "first_name": "Jane",
        "last_name": "Doe",
        "birth_date": "1975-03-20",
        "nationality": "US",
        "email": "jane.doe@acme.com",
        "title": "CEO",
        "ownership_percentage": 51,
        "residential_address": {
          "street_line_1": "456 Oak Avenue",
          "city": "Miami",
          "state": "FL",
          "postal_code": "33102",
          "country": "US"
        },
        "has_ownership": true,
        "has_control": true,
        "is_signer": true,
        "is_director": true
      }
    ],
    "account_purpose": "BusinessPayments",
    "source_of_funds": "Business",
    "estimated_annual_revenue_usd": "100KTo1M",
    "expected_monthly_payments_usd": "5KTo50K",
    "high_risk_activities": [],
    "documents": [
      {
        "purpose": "business_registration",
        "description": "Articles of Incorporation",
        "file": "https://example.com/docs/articles.pdf"
      }
    ]
  }'

{
  "success": true,
  "message": "Business KYC submission received successfully",
  "business_data": {
    "customer_id": "d47f8a2b-1c3e-4f5a-9b8c-7d6e5f4a3b2c",
    "type": "business",
    "business_legal_name": "Acme Corporation LLC",
    "status": "in_progress",
    "created_at": "2026-04-02T10:00:00.000000Z"
  }
}