v1

latestOpenAPI 3.1.02026-07-226250251.5 KB

Customers

Create Business Customer

Create a new business customer with verification details, addresses, and associated parties

post/v1/customers/business

Request body

verification_type'STANDARD' | 'RELIANCE'

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.

meta_dataobject

Additional custom metadata as key-value pairs

Example request

{
  "verification_type": "RELIANCE",
  "basic_info": {
    "business_name": "Acme Corp Ltd",
    "business_trade_name": "Acme",
    "description": "International software and payments company",
    "entity_type": "LIMITED_LIABILITY_COMPANY",
    "website": "https://fin.com",
    "email": "contact@acmecorp.com",
    "incorporation_date": "2018-06-15",
    "phone": "+14155552671",
    "country_of_incorporation": "USA",
    "registration_number": "12-3456789",
    "tax_id": "12-3456789"
  },
  "financial_profile": {
    "purpose_id": 10,
    "other_purpose": "custom other purpose",
    "business_industry_id": 1,
    "monthly_volume": 100000,
    "source_of_fund_id": 13
  },
  "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"
    },
    "physical_address": {
      "street": "456 Market Street Floor 3",
      "city": "San Francisco",
      "state": "US-CA",
      "postal_code": "94103",
      "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"
      }
    }
  ],
  "meta_data": {
    "reference": "ref-20250910-XYZ"
  }
}

Response

Business customer created successfully

Example response

{
  "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"
  }
}