🚀 VaultsPay API v1 is live. See what's new →
UsersUpdate Personal Info

Update Personal Info

Only allowed when KYC status is PENDING.

PATCH{baseUrl}/us/api/v1/kyc/personal

Payload

All fields are optional except userId (partial update).

AttributeTypeRequiredDescription
userIdIntegerYesTarget user ID.
firstNameStringNo
lastNameStringNo
nickNameStringNo
dobString (YYYY-MM-DD)No
genderEnumNoMALE | FEMALE | OTHER.
maritalStatusEnumNoSINGLE | MARRIED | DIVORCED | …
nationalityISO Alpha-3No
countryOfBirthISO Alpha-3No
countryOfResidenceISO Alpha-3No
tinStringNo
languageStringNo
Request Example
{
  "userId": 5,
  "firstName": "Maluk",
  "lastName": "Antique",
  "nickName": "Maluk",
  "dob": "1990-05-15",
  "gender": "MALE",
  "maritalStatus": "SINGLE",
  "nationality": "PAK",
  "countryOfBirth": "USA",
  "countryOfResidence": "UKR",
  "tin": "0112133232",
  "language": "ENGLISH"
}

Response

FieldTypeDescription
userIdInteger
firstNameString
lastNameString
nickNameString
dobString (ISO 8601)e.g., 1990-05-15T00:00:00.000+00:00.
genderEnum
maritalStatusEnum
nationalityStringISO Alpha-3.
countryOfBirthStringISO Alpha-3.
countryOfResidenceStringISO Alpha-3.
languageString
tinString
statusEnumPENDING | VERIFIED | REJECTED | …
200 — SUCCESS
{
  "userId": 603,
  "firstName": "Maluk",
  "lastName": "Antique",
  "nickName": "Maluk",
  "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"
}