Update KYC Identification Info
Same fields as Create Identification but for updating existing identification records. Admin verifies and controls final kycStatus.
PATCH{baseUrl}/us/api/v1/kyc/identification
Payload
All fields are optional except userId (partial update).
| Attribute | Type | Required | Description |
|---|---|---|---|
| userId | Integer | Yes | Target user ID. |
| selfieId | Integer | No | Uploaded selfie file ID. |
| idFrontId | Integer | No | Front image file ID of ID card. |
| idBackId | Integer | No | Back image file ID of ID card. |
| idExpiryDate | Timestamp (ISO 8601) | No | ID card expiry. |
| idNumber | String (6–30) | No | Official ID number. |
| idVerified | Boolean | No | Whether ID is verified. |
| passportId | Integer | No | Passport image file ID. |
| passportExpiryDate | Timestamp | No | Passport expiry. |
| passportNumber | String (6–9) | No | Passport number. |
| passportVerified | Boolean | No | Whether passport is verified. |
| drivingLicenseId | Integer | No | Driving license image file ID. |
| drivingLicenseExpiryDate | Timestamp | No | Driving license expiry. |
| drivingLicenseNumber | String (6–20) | No | Driving license number. |
| drivingLicenseVerified | Boolean | No | Whether driving license is verified. |
| residencePermitId | Integer | No | Residence permit image file ID. |
| residencePermitExpiryDate | Timestamp | No | Residence permit expiry. |
| residencePermitNumber | String (6–20) | No | Residence permit number. |
| residencePermitVerified | Boolean | No | Whether residence permit is verified. |
Request Example
{
"userId": 602,
"selfieId": 1,
"idFrontId": 1,
"idBackId": 1,
"idExpiryDate": "2025-02-19T10:30:00Z",
"idNumber": "ABC123XYZ",
"idVerified": true,
"passportId": 1,
"passportExpiryDate": "2026-02-19T10:30:00Z",
"passportNumber": "P123456",
"passportVerified": true,
"drivingLicenseId": 2,
"drivingLicenseExpiryDate": "2027-05-10T15:00:00Z",
"drivingLicenseNumber": "DL789456",
"drivingLicenseVerified": false,
"residencePermitId": 3,
"residencePermitExpiryDate": "2028-08-22T12:45:00Z",
"residencePermitNumber": "RP654321",
"residencePermitVerified": true,
"kycStatus": "VERIFIED"
}Response
| Field | Type | Description |
|---|---|---|
| id | Integer | Identification record ID. |
| selfie | Object | Uploaded selfie metadata (id, name, originalName, mime, size, fileType, fileKey, privateAccessUrl, publicAccessUrl, createdAt, createdBy, updatedAt, updatedBy). |
| idFront / idBack | Object | ID card images metadata (same structure as selfie). |
| idExpiryDate | String (ISO 8601) | ID card expiry. |
| idNumber | String | ID number. |
| idVerified | Boolean | Whether ID card is verified. |
| passport | Object | Passport image metadata. |
| passportExpiryDate | String | Passport expiry. |
| passportNumber | String | Passport number. |
| passportVerified | Boolean | Whether passport is verified. |
| drivingLicense | Object | Driving license image metadata. |
| drivingLicenseExpiryDate | String | DL expiry. |
| drivingLicenseNumber | String | DL number. |
| drivingLicenseVerified | Boolean | Whether DL is verified. |
| residencePermit | Object | Residence permit image metadata. |
| residencePermitExpiryDate | String | RP expiry. |
| residencePermitNumber | String | RP number. |
| residencePermitVerified | Boolean | Whether RP is verified. |
| kycStatus | Enum | PENDING | VERIFIED | REJECTED (Admin-updated). |