Skip to main content
POST
/
v1
/
customers
/
business
Create Business Customer
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/business \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "basic_info": {
    "business_name": "Acme Corp Ltd",
    "description": "International software and payments company",
    "entity_type": "LIMITED_LIABILITY_COMPANY",
    "website": "https://acmecorp.com",
    "email": "contact@acmecorp.com",
    "incorporation_date": "2018-06-15",
    "phone": "+14155552671",
    "country_of_incorporation": "USA",
    "registration_number": "12-3456789",
    "tax_id": "12-3456789",
    "business_trade_name": "Acme"
  },
  "financial_profile": {
    "purpose_id": 10,
    "business_industry_id": 1,
    "monthly_volume": 100000,
    "source_of_fund_id": 13,
    "third_party_fund_usage": false,
    "other_purpose": "custom other purpose"
  },
  "addresses": {
    "is_incorporated_address_same": true,
    "incorporated_address": {
      "street": "10 Anson Road #26-04 International Plaza",
      "city": "Singapore",
      "state": "SG-01",
      "postal_code": "079903",
      "country": "USA"
    }
  },
  "associated_parties": [
    {
      "basic_info": {
        "first_name": "John",
        "last_name": "Doe",
        "dob": "1985-03-20",
        "email": "john.doe@acmecorp.com",
        "phone": "+14155551234",
        "country_of_residence": "USA",
        "nationality": "USA",
        "tin": "123-45-6789"
      },
      "address": {
        "street": "456 Oak Avenue",
        "city": "San Francisco",
        "state": "US-CA",
        "postal_code": "94102",
        "country": "USA"
      },
      "ownership_info": {
        "designation": "CEO",
        "percentage_of_ownership": 75,
        "relationship_establishment_date": "2018-06-15"
      }
    }
  ],
  "verification_type": "RELIANCE",
  "meta_data": {
    "reference": "ref-20250910-XYZ"
  }
}
'
{
  "data": {
    "customer_id": "2d0a9df3-e1e5-4955-9759-ce0522e0ddc9",
    "tos_policies_url": "https://orchestration.fin.com/orchestration-customer-tos?customer_id=2d0a9df3-e1e5-4955-9759-ce0522e0ddc9&tos_policies_value=f11e77c6-8dc0-4d4b-a3f2-ed84c8ccfc69"
  }
}
Only English (Latin) characters are allowed as inputs for all fields.

​
Important Requirements

  • Email Address: Must be all lowercase or you will receive a validation error
  • RELIANCE Verification: If you attempt to use RELIANCE verification type but it’s not enabled for your client, you will receive a 423 error with message: “RELIANCE is not available for your client”
  • Third-party Fund Usage: The third_party_fund_usage field indicates whether this customer will be moving other people’s money
  • Ownership Percentages: The total ownership percentages of all associated parties must add up to more than 0 and less than 100

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Body

application/json
​
basic_info
object
required
​
financial_profile
object
required
​
addresses
object
required
​
associated_parties
object[]
required

Array of associated parties (UBOs, directors, shareholders, etc.)

Minimum array length: 1
​
verification_type
enum<string>

Type of verification to perform (optional, defaults to STANDARD). Note that RELIANCE verification must be enabled for your client, or you will receive a 423 error.

Available options:
STANDARD,
RELIANCE
Example:

"RELIANCE"

​
meta_data
object

Additional custom metadata as key-value pairs

Example:
{ "reference": "ref-20250910-XYZ" }

Response

Business customer created successfully

​
data
object