> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# Individual Registration
> Register a new B2C individual customer
export function RequiredRunnerHeaders() {
return <>
Client source IP (runner default: `127.0.0.1`)
Tenant identifier
Client source identifier (runner default: `integration-client`)
Client platform (runner default: `web`)
Device identifier (runner default: `integration-device`)
Bearer token
;
}
# Individual Registration
Creates an individual customer, linked person, and initial user in `PENDING_ACTIVATION`.
## Endpoint
`POST /api/v2.1/customer/individual/registration`
## Key Defaults (from B2C runner)
* `password` and `matchingPassword`: `SecurePass123!`
* Category example: `fs-cat-b2c-low-001` (`Individual Standard`)
* Role IDs: `ACCOUNT_OWNER`, `USER`
## Required Headers
## Example Request
```json theme={null}
{
"firstName": "John",
"lastName": "Customer",
"email": "customer.20260331114946-387074@testcorp.com",
"phone": "+37062767557",
"password": "SecurePass123!",
"matchingPassword": "SecurePass123!",
"dateOfBirth": "1990-05-15",
"gender": "MALE",
"nationality": "Lithuania",
"placeOfBirth": "Vilnius",
"pincode": "12345",
"roleIds": ["ACCOUNT_OWNER", "USER"],
"customerCategory": {
"id": "fs-cat-b2c-low-001",
"name": "Individual Standard"
}
}
```
## cURL
```bash theme={null}
curl -X POST "https://sandbox.finhub.cloud/api/v2.1/customer/individual/registration" \
-H "Content-Type: application/json" \
-H "X-Tenant-ID: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d @registration.json
```
## Success Response
```json 200 theme={null}
{
"code": 200,
"data": {
"id": "2dac1793-ab48-420c-b0b5-01292302e188",
"customerStatus": "CS_REGISTRATION_COMPLETED",
"user": {
"id": "0d488f57-57ef-4f9a-88a6-f89121cab838",
"email": "customer.20260331114946-387074@testcorp.com"
}
},
"message": "B2C individual account created successfully"
}
```
Used in B2C step runner Step 3 and mirrored in `individual-playground.crx.js`.
## OpenAPI
````yaml fincheck.yaml POST /api/v2.1/customer/individual/registration
openapi: 3.0.3
info:
title: Fincheck Endpoint Set
version: 1.1.0
description: |
Focused API spec for Customer APIs and Verification & Compliance endpoints,
aligned to business-bff B2C/B2B runners and dump payloads.
servers:
- url: https://sandbox.finhub.cloud
security: []
paths:
/api/v2.1/customer/individual/registration:
post:
operationId: registerIndividualCustomer
parameters:
- $ref: '#/components/parameters/XForwardedFor'
- $ref: '#/components/parameters/XTenantId'
- $ref: '#/components/parameters/XForwardedFrom'
- $ref: '#/components/parameters/Platform'
- $ref: '#/components/parameters/DeviceId'
- $ref: '#/components/parameters/Authorization'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/IndividualRegistration'
responses:
'200':
description: Registered
components:
parameters:
XForwardedFor:
in: header
name: X-Forwarded-For
required: true
schema:
type: string
example: 127.0.0.1
XTenantId:
in: header
name: X-Tenant-ID
required: true
schema:
type: string
example: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
XForwardedFrom:
in: header
name: X-Forwarded-From
required: true
schema:
type: string
example: integration-client
Platform:
in: header
name: platform
required: true
schema:
type: string
example: web
DeviceId:
in: header
name: deviceId
required: true
schema:
type: string
example: integration-device
Authorization:
in: header
name: Authorization
required: true
schema:
type: string
example: Bearer YOUR_ACCESS_TOKEN
schemas:
IndividualRegistration:
type: object
required:
- firstName
- lastName
- email
- phone
- password
- matchingPassword
- dateOfBirth
- gender
- nationality
- placeOfBirth
- pincode
- roleIds
- customerCategory
- individualCustomer
properties:
firstName:
type: string
example: John
lastName:
type: string
example: Customer
email:
type: string
example: customer.20260331114946-387074@testcorp.com
phone:
type: string
example: '+37062767557'
password:
type: string
example: SecurePass123!
matchingPassword:
type: string
example: SecurePass123!
dateOfBirth:
type: string
example: '1990-05-15'
gender:
type: string
example: MALE
nationality:
type: string
example: Lithuania
placeOfBirth:
type: string
example: Vilnius
pincode:
type: string
example: '12345'
roleIds:
type: array
items:
type: string
example:
- ACCOUNT_OWNER
- USER
customerCategory:
type: object
required:
- id
- name
properties:
id:
type: string
example: fs-cat-b2c-low-001
name:
type: string
example: Individual Standard
individualCustomer:
type: object
required:
- tenantId
- customerName
- person
- user
- categorization
properties:
tenantId:
type: string
example: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
customerName:
type: string
example: John Customer
person:
type: object
required:
- firstName
- lastName
- email
- dateOfBirth
- gender
- nationality
- addresses
- contacts
properties:
id:
type: string
example: de19a5c7-dd3b-4465-8e43-d8f84bd2cd22
firstName:
type: string
example: John
lastName:
type: string
example: Customer
email:
type: string
example: customer.20260331114946-387074@testcorp.com
dateOfBirth:
type: string
example: '1990-05-15'
gender:
type: string
example: MALE
nationality:
type: string
example: Lithuania
addresses:
type: array
items:
type: object
required:
- type
- street
- city
- state
- postalCode
- country
- isPrimary
properties:
id:
type: string
example: 8039cc36-d23e-40d7-93b0-9b2d8d85226b
type:
type: string
example: HOME
street:
type: string
example: 123 Test Street
city:
type: string
example: Vilnius
state:
type: string
example: Vilnius County
postalCode:
type: string
example: '12345'
country:
type: string
example: Lithuania
isPrimary:
type: boolean
example: true
contacts:
type: array
items:
type: object
required:
- type
- value
- isPrimary
properties:
id:
type: string
example: 8dd45f80-3884-461e-8f74-12f312525571
type:
type: string
example: EMAIL
value:
type: string
example: customer.20260331114946-387074@testcorp.com
isPrimary:
type: boolean
example: true
user:
type: object
required:
- tenantId
- username
- email
- password
- status
- roles
- isActive
properties:
id:
type: string
example: 7814d456-aee4-48f2-8f26-b39feae73c62
tenantId:
type: string
example: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
username:
type: string
example: customer.20260331114946-387074@testcorp.com
email:
type: string
example: customer.20260331114946-387074@testcorp.com
password:
type: string
example: SecurePass123!
status:
type: string
example: PENDING_ACTIVATION
roles:
type: array
items:
type: string
example:
- ACCOUNT_OWNER
- USER
isActive:
type: boolean
example: false
categorization:
type: object
required:
- id
- name
- description
- isActive
properties:
id:
type: string
example: fs-cat-b2c-low-001
name:
type: string
example: Individual Standard
description:
type: string
example: Individual Standard
isActive:
type: boolean
example: true
example:
firstName: John
lastName: Customer
email: customer.20260331114946-387074@testcorp.com
phone: '+37062767557'
password: SecurePass123!
matchingPassword: SecurePass123!
dateOfBirth: '1990-05-15'
gender: MALE
nationality: Lithuania
placeOfBirth: Vilnius
pincode: '12345'
roleIds:
- ACCOUNT_OWNER
- USER
customerCategory:
id: fs-cat-b2c-low-001
name: Individual Standard
individualCustomer:
customerName: John Customer
tenantId: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
````