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"
      }
    ]
  }
}
'

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

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"
      }
    ]
  }
}
'

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

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