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": "proposed"
}

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

KYC

Submit KYC

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 proposed; 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": "proposed"
}

"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

Search customer wallets Get KYC status

⌘I

User Authentication

Ramp API

Lookup API

Submit KYC

Authorizations

Path Parameters

Body

Response