🚀 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"
}