Skip to main content
POST
/
v1
/
customers
/
individual
Create Individual Customer
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/individual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "verification_type": "STANDARD",
  "basic_info": {
    "first_name": "John",
    "last_name": "Doe",
    "dob": "1990-01-15",
    "email": "john.doe@example.com",
    "phone": "+1234567890",
    "country_of_residence": "AFG",
    "nationality": "AFG",
    "tin": "123-45-6789"
  },
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "US-NY",
    "postal_code": "10001",
    "country": "AFG"
  },
  "financial_profile": {
    "occupation_id": 1,
    "source_of_fund_id": 1,
    "purpose_id": 1,
    "monthly_volume_usd": 5000
  },
  "meta_data": {
    "customer_reference": "REF-12345",
    "internal_notes": "VIP customer"
  }
}
'
{
  "data": {
    "customer_id": "55bd6b4e-c20a-4cc8-9535-91d5557a67d9",
    "tos_policies_url": "https://orchestration.fin.com/orchestration-customer-tos?customer_id=55bd6b4e-c20a-4cc8-9535-91d5557a67d9&tos_policies_value=e9414388-fbdf-4407-b5c2-bc39eae3645b"
  }
}
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”

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
verification_type
enum<string>
required

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

Available options:
STANDARD,
RELIANCE
Example:

"STANDARD"

​
basic_info
object
required
​
address
object
required
​
financial_profile
object
required
​
meta_data
object

Additional custom metadata as key-value pairs

Example:
{
  "customer_reference": "REF-12345",
  "internal_notes": "VIP customer"
}

Response

Individual customer created successfully

​
data
object