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"
  }
}
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.