Skip to main content
POST
/
accounts
/
{address}
/
kyc
cURL
curl --request POST \
  --url https://grid.squads.xyz/api/grid/v1/accounts/{address}/kyc \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "<string>",
  "endorsements": [
    "<string>"
  ],
  "full_name": "<string>",
  "redirect_uri": "<string>",
  "type": "<string>"
}'
{
  "data": {
    "created_at": "2023-11-07T05:31:56Z",
    "customer_id": "<string>",
    "email": "<string>",
    "full_name": "<string>",
    "id": "<string>",
    "kyc_link": "<string>",
    "kyc_status": "<string>",
    "persona_inquiry_type": "<string>",
    "rejection_reasons": "<any>",
    "tos_link": "<string>",
    "tos_status": "<string>",
    "type": "<string>"
  },
  "metadata": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}
KYC (Know Your Customer) verification establishes compliance status for your account. This is a direct operation that doesn’t require intents.

Verification Flow

Customer Types

Grid supports two types of customer verification:
Customer TypeVerification Requirements
Individual (KYC)• Personal identification
• Address verification
• Basic information collection
Business (KYB)• Business registration
• Beneficial ownership
• Business address verification

Important Notes

  • KYC verification is required for fiat payment rails
  • The verification link expires after 24 hours
  • Verification typically takes 1-3 business days
  • You can check status using the returned KYC ID

Authorizations

Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Path Parameters

address
string
required

Smart account address (Solana public key)

Body

application/json
email
string
required
endorsements
string[]
required
full_name
string
required
type
string
required
redirect_uri
string | null

Response

KYC link created successfully

data
object
required
metadata
object
required