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>'
{
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "walletPublicKey": "9Qx7r...",
  "status": "approved",
  "onChainMarked": true,
  "currentRejectionReason": null,
  "selfies": [],
  "documents": [],
  "currentKycInfo": {
    "id": "info-123",
    "email": "[email protected]",
    "phoneNumber": "+521234567890",
    "dateOfBirth": "1990-05-15",
    "name": {
      "givenName": "Juan",
      "familyName": "Garcia"
    },
    "address": {
      "street": "Av. Reforma 123",
      "city": "Mexico City",
      "region": "CDMX",
      "postalCode": "06600",
      "country": "MX"
    },
    "idNumbers": [
      {
        "value": "GAJU900515HDFRNN09",
        "type": "CURP"
      }
    ]
  },
  "approvedAt": "2024-01-01T00:00:00Z"
}

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
customer_id
string<uuid>
required

ID of the customer

​
pubkey
string
required

Wallet public key

Response

KYC status retrieved successfully

KYC status and submission details for a customer's wallet

​
customerId
string<uuid>

Customer ID

​
walletPublicKey
string

Wallet public key

​
status
enum<string>

Current KYC status. The approved_chain_deploying status indicates approval is complete but on-chain marking is in progress (Solana only).

Available options:
not_started,
proposed,
approved,
approved_chain_deploying,
rejected
​
onChainMarked
boolean | null

Whether KYC is marked on the blockchain. Only present for Solana wallets.

​
currentRejectionReason
string | null

Reason for rejection (if status is rejected)

​
selfies
object[]

Selfie verification images submitted by this partner

​
documents
object[]

Identity documents submitted by this partner

​
currentKycInfo
object

Identity information for a user

​
approvedAt
string<date-time> | null

Timestamp when KYC was approved