Upload KYC documents

curl --request POST \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/kyc/documents \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pubkey": "9Qx7r...",
  "documentType": "document",
  "images": [
    {
      "label": "id_front",
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    },
    {
      "label": "id_back",
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    }
  ]
}
'

{
  "status": "proposed",
  "message": "Documents uploaded for review"
}

KYC

Upload KYC documents

Upload identity documents (government ID, selfie) for a customer.

Document requirements:

Formats: JPEG, PNG
Max size: 10MB per image
Required documents: id_front, id_back (if applicable), selfie
Encoding: Base64

Submit documents using the documentType field:

document: For government ID images (front and back)
selfie: For selfie verification photo

Submitted documents will be reviewed by Etherfuse admins before approval. You’ll receive a kyc_updated webhook when the status changes.

Sandbox auto-approval: In sandbox, uploading documents for a personal customer org immediately approves the customer and fires a kyc_updated webhook. The response status returns "approved" (not "proposed"). This shortcut is sandbox-only — production still requires manual review.

POST

ramp

customer

{customer_id}

kyc

documents

Upload KYC documents

curl --request POST \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/kyc/documents \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pubkey": "9Qx7r...",
  "documentType": "document",
  "images": [
    {
      "label": "id_front",
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    },
    {
      "label": "id_back",
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    }
  ]
}
'

{
  "status": "proposed",
  "message": "Documents uploaded for review"
}

Authorizations

Authorization

string

header

required

API key for authentication. Pass the key directly (e.g., Authorization: your-api-key). Do not use a Bearer prefix.

Path Parameters

customer_id

string<uuid>

required

ID of the customer

Body

application/json

Request body for uploading KYC identity documents

documentType

enum<string>

required

Type of document being uploaded (government ID or selfie photo)

Available options:

document,

selfie

images

object[]

required

Array of images as data URLs (JPEG or PNG, max 10MB each)

Show child attributes

pubkey

string

Public key of the wallet to upload documents for. Optional — if omitted, documents are attached at the organization level.

Response

Documents uploaded successfully

status

string

Example:

"proposed"

message

string

Example:

"Documents uploaded for review"

Get KYC status Create webhook

⌘I

Documentation Index

Authorizations

Path Parameters

Body

Response