Compliance Endpoints

API endpoints for compliance and KYC/KYT operations.

1. Submit KYC

Submit customer KYC documents for verification.

curl --request POST \
  --url https://api.sandbox.celar.io/api/v1/compliance/kyc \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>' \
  --data '{
    "customer_id": "<<customer_id>>",
    "document_type": "passport",
    "document_number": "AB123456",
    "document_country": "US",
    "document_front_url": "https://...",
    "document_back_url": "https://...",
    "selfie_url": "https://..."
  }'

2. Get KYC Status

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/compliance/kyc/<customer_id> \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>'

Response

{
  "customer_id": "cus_abc123",
  "kyc_status": "approved",
  "kyc_level": "full",
  "verified_at": "2024-01-01T00:00:00Z"
}

3. Transaction Screening (KYT)

Screen a wallet address for compliance risk.

curl --request POST \
  --url https://api.sandbox.celar.io/api/v1/compliance/kyt/screen \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>' \
  --data '{
    "address": "0x...",
    "chain": "base"
  }'

Response

{
  "address": "0x...",
  "risk_score": "low",
  "risk_signals": [],
  "screened_at": "2024-01-01T00:00:00Z"
}