Get passkey session
Passkeys
Get Passkey Session
Retrieve a session URL with challenge for passkey account lookup operations.
Get passkey session
Generates a session URL containing a WebAuthn challenge for passkey account lookup operations. Use when you need to find a passkey account but don’t have the authenticator response yet.
This endpoint returns a URL for initiating a passkey lookup ceremony, while Find Passkey Account (POST /passkeys/find) accepts an authenticator response and returns account details.
Implementation Flow
1
Request Session URL
GET /passkeys/find to retrieve session URL
2
Load UI
Display URL in iframe (web) or WebBrowser (mobile)
3
User Selects Passkey
User completes WebAuthn get() ceremony
4
Receive Result
Hosted UI returns passkey account address via postMessage or redirect
GET vs POST Comparison
Challenge is valid for 60 seconds. This endpoint doesn’t create a session key—use /passkeys/auth for that.
Related Endpoints
- Find Passkey Account - Submit response to find account
- Get Passkey Account - Get account by address
- Authorize Passkey Session - Standard authentication
Authorizations
Your Grid API key from the Grid Dashboard
Headers
Solana network environment (sandbox, devnet, mainnet)
Body
application/json
Response
Passkey session URL retrieved successfully