Submit KYC

curl --request POST \
  --url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/kyc \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identity": {
    "email": "[email protected]",
    "phoneNumber": "+525512345678",
    "occupation": "Software Engineer",
    "dateOfBirth": "1990-05-15",
    "name": {
      "givenName": "Ana",
      "familyName": "García",
      "motherMaidenName": "López"
    },
    "address": {
      "street": "Av. Reforma 222",
      "city": "Ciudad de México",
      "region": "CDMX",
      "postalCode": "06600",
      "country": "MX"
    },
    "idNumbers": [
      {
        "type": "CURP",
        "value": "GALA900515MDFRPN08"
      },
      {
        "type": "RFC",
        "value": "GALA900515QX4"
      }
    ]
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    identity: {
      email: '[email protected]',
      phoneNumber: '+525512345678',
      occupation: 'Software Engineer',
      dateOfBirth: '1990-05-15',
      name: {givenName: 'Ana', familyName: 'García', motherMaidenName: 'López'},
      address: {
        street: 'Av. Reforma 222',
        city: 'Ciudad de México',
        region: 'CDMX',
        postalCode: '06600',
        country: 'MX'
      },
      idNumbers: [
        {type: 'CURP', value: 'GALA900515MDFRPN08'},
        {type: 'RFC', value: 'GALA900515QX4'}
      ]
    }
  })
};

fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/kyc', 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}/kyc"

payload = { "identity": {
        "email": "[email protected]",
        "phoneNumber": "+525512345678",
        "occupation": "Software Engineer",
        "dateOfBirth": "1990-05-15",
        "name": {
            "givenName": "Ana",
            "familyName": "García",
            "motherMaidenName": "López"
        },
        "address": {
            "street": "Av. Reforma 222",
            "city": "Ciudad de México",
            "region": "CDMX",
            "postalCode": "06600",
            "country": "MX"
        },
        "idNumbers": [
            {
                "type": "CURP",
                "value": "GALA900515MDFRPN08"
            },
            {
                "type": "RFC",
                "value": "GALA900515QX4"
            }
        ]
    } }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "message": "KYC data submitted for review",
  "status": "submitted"
}

phoneNumber is required; occupation is required; idNumbers may only be provided when address.country is MX

Deprecated

Submit KYC

deprecated

Deprecated. New integrations use Submit verification data, which writes onto the customer’s verification profile the hosted flow actually reads. See KYC API.

Submit identity information (name, address, DOB, tax ID) for a customer programmatically, an alternative to the presigned-URL flow where users complete KYC in the Etherfuse UI.

Use case: partners who want to white-label the KYC experience can collect identity data in their own UI and submit it here.

Submitted data is reviewed by Etherfuse admins before approval; you’ll receive a kyc_updated webhook when the status changes.

Sandbox auto-approval: in sandbox, a personal customer auto-approves once all agreements have been signed, with no manual review. Submitting KYC alone leaves the customer submitted; approval lands only after the rest of the programmatic flow (document upload and agreement signing) is complete, at which point a kyc_updated webhook fires and orders unlock for the wallet. This is sandbox-only; production still requires manual review.

Data isolation: partners can only query KYC data they submitted; data submitted by other partners or directly by users is not visible.

POST

ramp

customer

{customer_id}

kyc

Submit KYC

curl --request POST \
  --url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/kyc \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identity": {
    "email": "[email protected]",
    "phoneNumber": "+525512345678",
    "occupation": "Software Engineer",
    "dateOfBirth": "1990-05-15",
    "name": {
      "givenName": "Ana",
      "familyName": "García",
      "motherMaidenName": "López"
    },
    "address": {
      "street": "Av. Reforma 222",
      "city": "Ciudad de México",
      "region": "CDMX",
      "postalCode": "06600",
      "country": "MX"
    },
    "idNumbers": [
      {
        "type": "CURP",
        "value": "GALA900515MDFRPN08"
      },
      {
        "type": "RFC",
        "value": "GALA900515QX4"
      }
    ]
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    identity: {
      email: '[email protected]',
      phoneNumber: '+525512345678',
      occupation: 'Software Engineer',
      dateOfBirth: '1990-05-15',
      name: {givenName: 'Ana', familyName: 'García', motherMaidenName: 'López'},
      address: {
        street: 'Av. Reforma 222',
        city: 'Ciudad de México',
        region: 'CDMX',
        postalCode: '06600',
        country: 'MX'
      },
      idNumbers: [
        {type: 'CURP', value: 'GALA900515MDFRPN08'},
        {type: 'RFC', value: 'GALA900515QX4'}
      ]
    }
  })
};

fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/kyc', 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}/kyc"

payload = { "identity": {
        "email": "[email protected]",
        "phoneNumber": "+525512345678",
        "occupation": "Software Engineer",
        "dateOfBirth": "1990-05-15",
        "name": {
            "givenName": "Ana",
            "familyName": "García",
            "motherMaidenName": "López"
        },
        "address": {
            "street": "Av. Reforma 222",
            "city": "Ciudad de México",
            "region": "CDMX",
            "postalCode": "06600",
            "country": "MX"
        },
        "idNumbers": [
            {
                "type": "CURP",
                "value": "GALA900515MDFRPN08"
            },
            {
                "type": "RFC",
                "value": "GALA900515QX4"
            }
        ]
    } }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "message": "KYC data submitted for review",
  "status": "submitted"
}

phoneNumber is required; occupation is required; idNumbers may only be provided when address.country is MX

Authorizations

Authorization

string

header

required

API key sent in the Authorization header.

Path Parameters

customer_id

string<uuid>

required

The customer (child org) ID. Must belong to the caller's organization or a direct child.

Body

application/json

Request body for submitting KYC identity data. This endpoint is for personal accounts only; business/KYB fields are not accepted.

identity

object

required

Personal identity information for the customer.

Show child attributes

Response

KYC identity data submitted

User Authentication

Ramp API

Lookup API

Submit KYC

Authorizations

Path Parameters

Body

Response