Skip to main content
Find passkey account
curl --request POST \
  --url https://grid.squads.xyz/api/grid/v1/passkeys/find \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-grid-environment: <x-grid-environment>' \
  --data '
{
  "authenticatorResponse": {},
  "sessionKey": {
    "expiration": 1,
    "key": "11111111111111111111111111111111"
  }
}
'
{
  "passkey_account": "<string>",
  "session_key": {
    "expiration": 1,
    "key": "11111111111111111111111111111111"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.squads.so/llms.txt

Use this file to discover all available pages before exploring further.

The “Try It” feature is disabled for this endpoint because it requires cryptographic WebAuthn authenticator response data that can only be generated during a browser WebAuthn ceremony. Use the Integration Guide for implementation examples.
Finds and retrieves a passkey account by submitting a WebAuthn authenticator response. Useful for account recovery flows and cross-device login where you have the authenticator credential but not the on-chain address.

​
Use Cases

  • Account Recovery: User forgot which account they used but has the passkey
  • Cross-Device Login: User switches devices with synced passkeys
  • Multi-Passkey Management: Select which passkey/account to use

​
Implementation Flow

1

Initiate Get Ceremony

User triggers WebAuthn get() with appropriate challenge
2

Retrieve Credential

Browser/device returns authenticator response
3

Submit to Find

POST authenticator response to /passkeys/find
4

Use Account

Continue with account operations using returned address and session key
This endpoint only finds existing accounts—it doesn’t create new ones. The response includes a fresh session key regardless of existing session status.

Authorizations

​
Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Headers

​
x-grid-environment
string
required

Solana network environment (sandbox, devnet, mainnet)

Body

application/json
​
authenticatorResponse
object
required
​
sessionKey
object

Grid v1 API SessionKey type that supports backward-compatible deserialization from both raw bytes array (old format) and base58 string (new format). Always serializes to base58 string format.

Response

Passkey account found successfully

​
passkey_account
string
required
​
session_key
object

Grid v1 API SessionKey type that supports backward-compatible deserialization from both raw bytes array (old format) and base58 string (new format). Always serializes to base58 string format.