Skip to main content
GET
/
ramp
/
customer
/
{customer_id}
/
kyc
Get KYC status
curl --request GET \
  --url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/kyc \
  --header 'Authorization: <api-key>'
{
  "approvedAt": "2026-05-01T16:00:00Z",
  "currentRejectionReason": null,
  "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "documents": [],
  "needsWork": false,
  "selfies": [],
  "status": "approved",
  "walletPublicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL"
}

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.

Response

The org-level KYC status for the customer

KYC status response

​
customerId
string<uuid>
required
​
documents
object[]
required
​
needsWork
boolean
required
​
selfies
object[]
required
​
status
string
required
​
approvedAt
string<date-time> | null
​
currentRejectionReason
string | null
​
onChainMarked
boolean | null

Whether KYC is marked on-chain. Only present for Solana wallets. For other blockchain types (Stellar, EVM), this field is omitted as on-chain marking doesn't apply.

​
userMessage
string | null
​
walletPublicKey
string | null