Skip to main content
GET
/
accounts
/
{address}
/
kyc
/
{kyc_id}
cURL
curl --request GET \
  --url https://grid.squads.xyz/api/grid/v1/accounts/{address}/kyc/{kyc_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "created_at": "<string>",
    "id": "<string>",
    "status": "<string>",
    "tos_status": "<string>",
    "type": "<string>",
    "updated_at": "<string>",
    "account": "<string>",
    "kyc_continuation_link": "<string>",
    "rejection_reasons": [
      "<unknown>"
    ],
    "requirements_due": [
      "<string>"
    ]
  },
  "metadata": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}
Check the current verification status of a KYC request. Use this endpoint to monitor progress and determine account compliance status.

​
Verification Status Values

The verification process can result in these statuses:
  • not_started: Verification link created but not accessed
  • under_review: Documents submitted and being reviewed
  • incomplete: Additional information required
  • approved: Verification completed successfully
  • rejected: Verification failed

​
Terms of Service Status

Separate from KYC verification, terms of service acceptance is tracked:
  • pending: Terms not yet accepted
  • approved: Terms accepted

​
Important Notes

  • Status updates may take a few minutes to reflect
  • Rejected verifications include detailed rejection reasons
  • Incomplete verifications provide required next steps
  • Some statuses trigger webhooks if configured

Authorizations

​
Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Path Parameters

​
address
string
required

Smart account address (Solana public key)

​
kyc_id
string
required

KYC link ID

Response

KYC status retrieved successfully

​
data
object
required
​
metadata
object
required