Skip to main content
GET
/
smart-accounts
/
{smart_account_address}
/
kyc
/
{kyc_id}
cURL
curl --request GET \
  --url https://grid.squads.xyz/api/v0/grid/smart-accounts/{smart_account_address}/kyc/{kyc_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Grid-Environment: <x-grid-environment>'
{
  "created_at": "<string>",
  "customer_type": "individual",
  "id": "<string>",
  "kyc_continuation_link": "<string>",
  "rejection_reasons": [
    {
      "created_at": "<string>",
      "developer_reason": "<string>",
      "reason": "<string>"
    }
  ],
  "requirements_due": [
    "<string>"
  ],
  "status": "not_started",
  "tos_status": "pending",
  "updated_at": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Key for authentication

Headers

​
X-Grid-Environment
string
required

The environment you’re using. Can be sandbox or production.

Path Parameters

​
smart_account_address
string
required

The address of the smart account to get KYC status for

​
kyc_id
string
required

The KYC ID to get status for

Response

Successfully retrieved KYC status

​
created_at
string
required
​
customer_type
enum<string>
required
Available options:
individual,
business
​
id
string
required
​
status
enum<string>
required
Available options:
not_started,
under_review,
incomplete,
approved,
rejected
​
tos_status
enum<string>
required
Available options:
pending,
approved
​
updated_at
string
required
​
kyc_continuation_link
string | null
​
rejection_reasons
object[]
​
requirements_due
string[]