Skip to main content
POST
/
management
/
clients
/
business
curl -X POST "https://api.cryptomate.me/management/clients/business" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "business@techstartup.io",
    "business_legal_name": "TechStartup Solutions Inc.",
    "business_trade_name": "TechStartup",
    "business_description": "Software development company specializing in fintech solutions",
    "business_type": "corporation",
    "business_industry": ["541511"],
    "registered_address": {
      "street_line_1": "123 Main Street",
      "city": "San Francisco",
      "postal_code": "94102",
      "state": "USA-CA",
      "country": "USA"
    },
    "associated_persons": [
      {
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "jane.smith@techstartup.io",
        "birth_date": "1985-02-20",
        "residential_address": {
          "street_line_1": "456 Oak Ave",
          "city": "San Francisco",
          "postal_code": "94102",
          "state": "USA-CA",
          "country": "USA"
        },
        "has_ownership": true,
        "has_control": true,
        "is_signer": true,
        "identifying_information": [
          { "type": "ssn", "issuing_country": "USA", "number": "123-45-6789" }
        ]
      }
    ],
    "identifying_information": [
      { "type": "ein", "issuing_country": "USA", "number": "12-3456789" }
    ],
    "high_risk_activities": [],
    "primary_website": "https://www.techstartup.io"
  }'

{
  "id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "type": "business",
  "status": "PENDING",
  "business_legal_name": "TechStartup Solutions Inc.",
  "business_trade_name": "TechStartup",
  "email": "business@techstartup.io",
  "created_at": "2026-04-15T10:30:00",
  "updated_at": "2026-04-15T10:30:00"
}
Creates a new business client for the company with business information, associated persons, compliance data, and documents. Requires an API key with access level 3 or higher.

​
Body

​
email
string
required
Business email address.
​
business_legal_name
string
required
Legal business name.
​
business_trade_name
string
Business trade name (DBA).
​
business_description
string
required
Business description.
​
business_type
string
required
Business type. One of corporation, llc, partnership, sole_proprietorship, non_profit, trust, other.
​
business_industry
array
required
List of NAICS industry codes. Must contain at least one entry.
​
is_dao
boolean
Whether the business is a DAO.
​
registered_address
object
required
Registered business address with street_line_1, city, postal_code, state, country.state uses ISO 3166-2 codes that identify country subdivisions in the format {COUNTRY}-{SUBDIVISION} (e.g., USA-CA for California).
​
physical_address
object
Physical business address with street_line_1, city, postal_code, state, country.
​
associated_persons
array
required
List of associated persons. Must contain at least one entry. Each person includes first_name, last_name, email, birth_date, residential_address, optional roles (has_ownership, has_control, is_signer, is_director), identifying_information, and documents.residential_address.state uses ISO 3166-2 codes that identify country subdivisions in the format {COUNTRY}-{SUBDIVISION} (e.g., USA-CA for California). residential_address.country and identifying_information.issuing_country use ISO 3166-1 alpha-3 country codes (e.g., USA).
​
business_documents
array
List of business documents.
​
identifying_information
array
required
List of business identifying information (tax IDs: EIN, TIN, VAT, etc.). Must contain at least one entry. Each has type, issuing_country, number, optional description, expiration, image_front, image_back.issuing_country uses ISO 3166-1 alpha-3 country codes (e.g., USA).
​
has_material_intermediary_ownership
boolean
Whether there is material intermediary ownership.
​
ownership_threshold
integer
Ownership threshold percentage.
​
account_purpose
string
Account purpose.
​
account_purpose_other
string
Other account purpose description.
​
source_of_funds
string
Source of funds.
​
source_of_funds_description
string
Description of source of funds.
​
estimated_annual_revenue_usd
string
Estimated annual revenue bucket (USD).
​
expected_monthly_payments_usd
integer
Expected monthly payments (USD).
​
operates_in_prohibited_countries
boolean
Whether the business operates in prohibited countries.
​
high_risk_activities
array
required
High-risk activities selection. Required (may be an empty list explicitly).
​
high_risk_activities_explanation
string
Explanation of high-risk activities.
​
conducts_money_services
boolean
Whether the business conducts money services.
​
conducts_money_services_using_platform
boolean
Whether money services are conducted using the platform.
​
conducts_money_services_description
string
Description of money services.
​
compliance_screening_explanation
string
Compliance screening explanation.
​
acting_as_intermediary
boolean
Whether the business acts as an intermediary.
​
regulated_activity
object
Regulated activity details (free-form object).
​
primary_website
string
required
Primary website URL.
​
other_websites
array
List of other website URLs.
​
phone_country_code
integer
Phone country code.
​
phone_number
long
Phone number.
​
username
string
Client username.
​
otp
boolean
Enable OTP authentication.
​
sms
boolean
Enable SMS notifications.
​
whatsapp
boolean
Enable WhatsApp notifications.
​
telegram
boolean
Enable Telegram notifications.

​
Response

Returns the created business client. See Get client by ID for the full field list. 
curl -X POST "https://api.cryptomate.me/management/clients/business" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "business@techstartup.io",
    "business_legal_name": "TechStartup Solutions Inc.",
    "business_trade_name": "TechStartup",
    "business_description": "Software development company specializing in fintech solutions",
    "business_type": "corporation",
    "business_industry": ["541511"],
    "registered_address": {
      "street_line_1": "123 Main Street",
      "city": "San Francisco",
      "postal_code": "94102",
      "state": "USA-CA",
      "country": "USA"
    },
    "associated_persons": [
      {
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "jane.smith@techstartup.io",
        "birth_date": "1985-02-20",
        "residential_address": {
          "street_line_1": "456 Oak Ave",
          "city": "San Francisco",
          "postal_code": "94102",
          "state": "USA-CA",
          "country": "USA"
        },
        "has_ownership": true,
        "has_control": true,
        "is_signer": true,
        "identifying_information": [
          { "type": "ssn", "issuing_country": "USA", "number": "123-45-6789" }
        ]
      }
    ],
    "identifying_information": [
      { "type": "ein", "issuing_country": "USA", "number": "12-3456789" }
    ],
    "high_risk_activities": [],
    "primary_website": "https://www.techstartup.io"
  }'

{
  "id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "type": "business",
  "status": "PENDING",
  "business_legal_name": "TechStartup Solutions Inc.",
  "business_trade_name": "TechStartup",
  "email": "business@techstartup.io",
  "created_at": "2026-04-15T10:30:00",
  "updated_at": "2026-04-15T10:30:00"
}