curl --request POST \
--url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/verification \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "Ana",
"lastName": "Ejemplo",
"dateOfBirth": "1990-01-01",
"taxId": "XAXX010101000",
"additionalInfo": {
"curp": "XEXX010101HNEXXXA4"
},
"country": "MEX",
"address": {
"street": "Av. Reforma 100",
"city": "Ciudad de Mexico",
"region": "CDMX",
"postalCode": "06600",
"country": "MEX"
}
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: 'Ana',
lastName: 'Ejemplo',
dateOfBirth: '1990-01-01',
taxId: 'XAXX010101000',
additionalInfo: {curp: 'XEXX010101HNEXXXA4'},
country: 'MEX',
address: {
street: 'Av. Reforma 100',
city: 'Ciudad de Mexico',
region: 'CDMX',
postalCode: '06600',
country: 'MEX'
}
})
};
fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/verification', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/verification"
payload = {
"firstName": "Ana",
"lastName": "Ejemplo",
"dateOfBirth": "1990-01-01",
"taxId": "XAXX010101000",
"additionalInfo": { "curp": "XEXX010101HNEXXXA4" },
"country": "MEX",
"address": {
"street": "Av. Reforma 100",
"city": "Ciudad de Mexico",
"region": "CDMX",
"postalCode": "06600",
"country": "MEX"
}
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "in_progress"
}dateOfBirth must be a date in YYYY-MM-DD format; country 'MX' is not a recognized ISO 3166-1 alpha-3 country code (e.g. MEX); address.city is requiredThis customer's verification is already approved; it cannot be modifiedSubmit verification data
First call in the KYC API flow. Nothing else is accepted before it: country is what routes the customer to their country’s requirements.
Answers 202, not 200. The request is validated before we answer; recording it upstream happens after. A 202 means accepted, not satisfied. Read the result from the kyc_updated webhook or GET /ramp/customer/{customer_id}/kyc?requirements=true.
Re-submitting overwrites what was sent before, and never moves the customer’s review status on its own. Personal accounts only.
curl --request POST \
--url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/verification \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "Ana",
"lastName": "Ejemplo",
"dateOfBirth": "1990-01-01",
"taxId": "XAXX010101000",
"additionalInfo": {
"curp": "XEXX010101HNEXXXA4"
},
"country": "MEX",
"address": {
"street": "Av. Reforma 100",
"city": "Ciudad de Mexico",
"region": "CDMX",
"postalCode": "06600",
"country": "MEX"
}
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: 'Ana',
lastName: 'Ejemplo',
dateOfBirth: '1990-01-01',
taxId: 'XAXX010101000',
additionalInfo: {curp: 'XEXX010101HNEXXXA4'},
country: 'MEX',
address: {
street: 'Av. Reforma 100',
city: 'Ciudad de Mexico',
region: 'CDMX',
postalCode: '06600',
country: 'MEX'
}
})
};
fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/verification', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/verification"
payload = {
"firstName": "Ana",
"lastName": "Ejemplo",
"dateOfBirth": "1990-01-01",
"taxId": "XAXX010101000",
"additionalInfo": { "curp": "XEXX010101HNEXXXA4" },
"country": "MEX",
"address": {
"street": "Av. Reforma 100",
"city": "Ciudad de Mexico",
"region": "CDMX",
"postalCode": "06600",
"country": "MEX"
}
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "in_progress"
}dateOfBirth must be a date in YYYY-MM-DD format; country 'MX' is not a recognized ISO 3166-1 alpha-3 country code (e.g. MEX); address.city is requiredThis customer's verification is already approved; it cannot be modifiedAuthorizations
API key sent in the Authorization header.
Path Parameters
The customer (child org) ID. Must belong to the caller's organization or a direct child.
Body
Personal data a partner submits on the customer's behalf. A Mexican customer (country: "MEX") needs a CURP and RFC to complete verification.
YYYY-MM-DD. Any other format is a 400.
"1990-01-01"
The customer's tax identification number. The RFC for a Mexican customer.
"XAXX010101000"
The customer's country, as an ISO 3166-1 alpha-3 code. Alpha-2 codes and country names are rejected. This is the one country field for the customer (there is no separate nationality), and its value routes them to their country's requirements.
"MEX"
The customer's residential address. Required, and it must match the identity document you upload; the provider cross-checks the two.
Show child attributes
Show child attributes
Information beyond the standard personal data, which some verifications ask for.
Show child attributes
Show child attributes
Response
Accepted and being applied. The customer's current verification status is returned.
Where the customer's verification stands after a partner write. status is the same value GET /ramp/customer/{customer_id}/kyc reports, so there is one vocabulary across both.