Skip to main content
POST
/
v2
/
customers
/
individual
Create Individual Customer V2
curl --request POST \
  --url https://sandbox.api.fin.com/v2/customers/individual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "verification_type": "STANDARD",
  "basic_info": {
    "first_name": "Maria",
    "middle_name": "Elena",
    "last_name": "Garcia",
    "dob": "1990-04-15",
    "email": "maria.garcia@example.com",
    "phone": "+14155552671",
    "country_of_residence": "USA",
    "primary_nationality": "USA",
    "secondary_nationality": "MEX",
    "gender": "FEMALE",
    "tax_info": [
      {
        "country_code": "USA",
        "document_type": "SSN",
        "document_id": "123-45-6789"
      }
    ]
  },
  "address": {
    "street_line_1": "123 Market Street",
    "street_line_2": "Apt 4B",
    "city": "San Francisco",
    "subdivision_code": "US-CA",
    "postal_code": "94103",
    "country": "USA"
  },
  "financial_profile": {
    "employment_status": "EMPLOYED",
    "occupation_id": 42,
    "purpose_id": 3,
    "purpose_remarks": "Personal remittances to family",
    "source_of_funds_description": "Monthly salary from employment",
    "source_of_fund_ids": [
      1,
      5
    ],
    "monthly_volume_usd": 5000
  },
  "meta_data": {
    "reference": "client-ref-abc-001"
  }
}
'
{
  "data": {
    "customer_id": "0ca13984-63f3-45d7-99a7-52b9133f0259",
    "tos_policies_url": "https://orchestration.fin.com/orchestration-customer-tos?customer_id=0ca13984-63f3-45d7-99a7-52b9133f0259&tos_policies_value=7e8873f7-519b-43d7-9565-c81befc52dd6"
  }
}
Only English (Latin) characters are allowed as inputs for all fields. If any field contains non-ASCII characters, provide a transliterated (Latin) value in the corresponding _en field (e.g., first_name_en, street_line_1_en).

​
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”
  • Address country: address.country must match basic_info.country_of_residence
  • Reference Data: occupation_id, purpose_id, and source_of_fund_ids are integer foreign keys. Fetch valid values from List Occupations, List Account Purposes, and List Source of Funds
  • subdivision_code: Pass the ISO 3166-2 code. For example for CA, pass US-CA.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from Issue a Token endpoint

Body

application/json
​
verification_type
enum<string>
required
Available options:
STANDARD,
RELIANCE
Example:

"STANDARD"

​
basic_info
object
required
​
address
object
required
​
financial_profile
object
required
​
meta_data
object
Example:
{ "reference": "client-ref-abc-001" }

Response

Individual customer created successfully

​
data
object