Create Personal Info
POST{baseUrl}/us/api/v1/kyc/personal
Payload
| Attribute | Type | Required | Description |
|---|---|---|---|
| userId | Integer | Yes | ID of the user for whom the basic profile is being created. |
| firstName | String | Yes | User’s first name. |
| lastName | String | Yes | User’s last name. |
| nickName | String | No | Preferred name or alias. |
| dob | String (YYYY-MM-DD) | Yes | Date of birth. |
| gender | Enum (MALE, FEMALE, OTHER) | Yes | User’s gender. |
| maritalStatus | Enum (SINGLE, MARRIED) | No | Marital status. |
| nationality | ISO Alpha-3 | Yes | Nationality (e.g., PAK). |
| countryOfBirth | ISO Alpha-3 | No | Country of birth (e.g., USA). |
| countryOfResidence | ISO Alpha-3 | No | Current country of residence (e.g., UKR). |
| tin | String | No | Tax Identification Number. |
| language | String/Enum | No | Preferred language (e.g., ENGLISH). |
Request Example
{
"userId": 604,
"firstName": "sardar",
"lastName": "adil",
"nickName": "sardarAdil",
"dob": "1990-05-15",
"gender": "MALE",
"maritalStatus": "SINGLE",
"nationality": "PAK",
"countryOfBirth": "USA",
"countryOfResidence": "UKR",
"tin": "0112133232",
"language": "ENGLISH"
}Response
| Field | Type | Description |
|---|---|---|
| userId | Integer | User ID. |
| firstName | String | Stored first name. |
| lastName | String | Stored last name. |
| nickName | String | Stored nickname (if provided). |
| dob | String (ISO 8601) | Date of birth with time & timezone. |
| gender | Enum | MALE | FEMALE | OTHER. |
| maritalStatus | Enum | SINGLE | MARRIED | DIVORCED | … |
| nationality | ISO Alpha-3 | Nationality code. |
| countryOfBirth | ISO Alpha-3 | Birth country code. |
| countryOfResidence | ISO Alpha-3 | Residence country code. |
| language | String | Preferred language. |
| tin | String | Tax ID. |
| status | Enum | PENDING | VERIFIED | REJECTED | … |
200 — SUCCESS
{
"userId": 604,
"firstName": "sardar",
"lastName": "adil",
"nickName": "sardarAdil",
"dob": "1990-05-15T00:00:00.000+00:00",
"gender": "MALE",
"maritalStatus": "SINGLE",
"nationality": "PAK",
"countryOfBirth": "USA",
"countryOfResidence": "UKR",
"language": "ENGLISH",
"tin": "0112133232",
"status": "PENDING"
}Error Responses
| HTTP | Code | Type | Meaning / Notes |
|---|---|---|---|
| 400 | 1000 | INVALID_PAYLOAD | Missing/invalid fields. |
| 401 | 1001 | UNAUTHORISED | Not permitted. |
| 401 | 1003 | TOKEN_EXPIRED | accessToken expired; refresh token. |
| 401 | 1004 | SESSION_EXPIRED | Session expired; login again. |