v1
latestOpenAPI 3.1.02026-07-226250251.5 KBCustomers
Create Individual Customer V2
Create a new individual customer with verification details, basic info, address, and financial profile.
post/v2/customers/individual
Request body
Example request
{
"verification_type": "STANDARD",
"basic_info": {
"first_name": "Maria",
"first_name_en": "Maria",
"middle_name": "Elena",
"middle_name_en": "Elena",
"last_name": "Garcia",
"last_name_en": "Garcia",
"dob": "1990-04-15",
"email": "maria.garcia@example.com",
"phone": "+14155552671",
"country_of_residence": "USA",
"primary_nationality": "USA",
"secondary_nationality": "USA",
"gender": "FEMALE",
"tax_info": [
{
"country_code": "USA",
"document_type": "SSN",
"document_id": "123-45-6789"
}
]
},
"address": {
"street_line_1": "123 Market Street",
"street_line_1_en": "123 Market Street",
"street_line_2": "Apt 4B",
"street_line_2_en": "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_fund_ids": [
1,
5
],
"source_of_funds_description": "Monthly salary from employment",
"monthly_volume_usd": 5000
},
"meta_data": {
"reference": "client-ref-abc-001"
}
}Response
Individual customer created successfully
Example response
{
"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"
}
}