curl -X PUT 'https://api.yativo.com/api/v1/customer/kyc/update' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: kyc-update-2026-002' \
-d '{
"customer_id": "c586066b-0f29-468f-b775-15483871a202",
"type": "individual",
"selfie_image": "https://storage.yativo.com/documents/abc/selfie-v2.jpg",
"identifying_information": [
{
"type": "passport",
"issuing_country": "US",
"number": "P00012345",
"date_issued": "2020-01-01",
"expiration_date": "2030-01-01",
"image_front_file": "https://storage.yativo.com/documents/abc/passport-front-hd.jpg"
}
]
}'
const response = await fetch('https://api.yativo.com/api/v1/customer/kyc/update', {
method: 'PUT',
headers: {
'X-Api-Key': process.env.YATIVO_API_KEY,
'X-Api-Secret': process.env.YATIVO_API_SECRET,
'Content-Type': 'application/json',
'Idempotency-Key': `kyc-update-${customerId}-${Date.now()}`,
},
body: JSON.stringify({
customer_id: customerId,
type: 'individual',
selfie_image: newSelfieUrl,
identifying_information: [{
type: 'passport',
issuing_country: 'US',
number: 'P00012345',
date_issued: '2020-01-01',
expiration_date: '2030-01-01',
image_front_file: newPassportFrontUrl,
}],
}),
});
const data = await response.json();
{
"status": "success",
"status_code": 200,
"message": "KYC submission updated successfully",
"data": {
"customer_id": "c586066b-0f29-468f-b775-15483871a202",
"type": "individual",
"status": "submitted",
"updated_at": "2026-06-01T15:00:00.000000Z"
}
}
{
"status": "failed",
"status_code": 422,
"message": "Request failed",
"data": {
"customer_id": ["The customer id field is required."],
"type": ["The selected type is invalid."]
}
}
KYC / KYB
Update KYC Submission
Update an existing KYC or KYB submission with corrected or additional information
PUT
/
customer
/
kyc
/
update
curl -X PUT 'https://api.yativo.com/api/v1/customer/kyc/update' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: kyc-update-2026-002' \
-d '{
"customer_id": "c586066b-0f29-468f-b775-15483871a202",
"type": "individual",
"selfie_image": "https://storage.yativo.com/documents/abc/selfie-v2.jpg",
"identifying_information": [
{
"type": "passport",
"issuing_country": "US",
"number": "P00012345",
"date_issued": "2020-01-01",
"expiration_date": "2030-01-01",
"image_front_file": "https://storage.yativo.com/documents/abc/passport-front-hd.jpg"
}
]
}'
const response = await fetch('https://api.yativo.com/api/v1/customer/kyc/update', {
method: 'PUT',
headers: {
'X-Api-Key': process.env.YATIVO_API_KEY,
'X-Api-Secret': process.env.YATIVO_API_SECRET,
'Content-Type': 'application/json',
'Idempotency-Key': `kyc-update-${customerId}-${Date.now()}`,
},
body: JSON.stringify({
customer_id: customerId,
type: 'individual',
selfie_image: newSelfieUrl,
identifying_information: [{
type: 'passport',
issuing_country: 'US',
number: 'P00012345',
date_issued: '2020-01-01',
expiration_date: '2030-01-01',
image_front_file: newPassportFrontUrl,
}],
}),
});
const data = await response.json();
{
"status": "success",
"status_code": 200,
"message": "KYC submission updated successfully",
"data": {
"customer_id": "c586066b-0f29-468f-b775-15483871a202",
"type": "individual",
"status": "submitted",
"updated_at": "2026-06-01T15:00:00.000000Z"
}
}
{
"status": "failed",
"status_code": 422,
"message": "Request failed",
"data": {
"customer_id": ["The customer id field is required."],
"type": ["The selected type is invalid."]
}
}
Update a previously submitted KYC or KYB record. Use this endpoint when a customer needs to correct information or provide additional documents — typically after a rejection. Only include fields you want to change.
PUT https://api.yativo.com/api/v1/customer/kyc/update
Include an
Idempotency-Key header on every request. Supply customer_id and type, then any fields you want to update. Fields not included are left unchanged.Request body
All other fields from the original submission schema can be included to update their values. See Submit Individual KYC or Submit Business KYC for the full field reference.curl -X PUT 'https://api.yativo.com/api/v1/customer/kyc/update' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: kyc-update-2026-002' \
-d '{
"customer_id": "c586066b-0f29-468f-b775-15483871a202",
"type": "individual",
"selfie_image": "https://storage.yativo.com/documents/abc/selfie-v2.jpg",
"identifying_information": [
{
"type": "passport",
"issuing_country": "US",
"number": "P00012345",
"date_issued": "2020-01-01",
"expiration_date": "2030-01-01",
"image_front_file": "https://storage.yativo.com/documents/abc/passport-front-hd.jpg"
}
]
}'
const response = await fetch('https://api.yativo.com/api/v1/customer/kyc/update', {
method: 'PUT',
headers: {
'X-Api-Key': process.env.YATIVO_API_KEY,
'X-Api-Secret': process.env.YATIVO_API_SECRET,
'Content-Type': 'application/json',
'Idempotency-Key': `kyc-update-${customerId}-${Date.now()}`,
},
body: JSON.stringify({
customer_id: customerId,
type: 'individual',
selfie_image: newSelfieUrl,
identifying_information: [{
type: 'passport',
issuing_country: 'US',
number: 'P00012345',
date_issued: '2020-01-01',
expiration_date: '2030-01-01',
image_front_file: newPassportFrontUrl,
}],
}),
});
const data = await response.json();
{
"status": "success",
"status_code": 200,
"message": "KYC submission updated successfully",
"data": {
"customer_id": "c586066b-0f29-468f-b775-15483871a202",
"type": "individual",
"status": "submitted",
"updated_at": "2026-06-01T15:00:00.000000Z"
}
}
{
"status": "failed",
"status_code": 422,
"message": "Request failed",
"data": {
"customer_id": ["The customer id field is required."],
"type": ["The selected type is invalid."]
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Body
application/json

