Skip to main content
GET
/
ramp
/
customer
/
{customer_id}
/
kyc
/
{pubkey}
Get KYC status
curl --request GET \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/kyc/{pubkey} \
  --header 'Authorization: <api-key>'
{
  "approvedAt": "2026-05-01T16:00:00Z",
  "currentKycInfo": {
    "email": "[email protected]",
    "id": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
    "name": {
      "familyName": "García",
      "givenName": "Ana"
    }
  },
  "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.

​
pubkey
string
required

The wallet public key

Response

The KYC status for the customer's wallet

KYC status response

​
currentKycInfo
object
required
​
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