GET
/
identity
/
session
/
{walletAddress}
cURL
curl -X GET 'https://core-api-server.onrender.com/identity/session/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU' \
  -H 'Accept: application/json'
{
  "message": "Identity verification session retrieved successfully",
  "details": {
    "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "status": "pending",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "expiresAt": "2024-01-16T10:30:00.000Z",
    "verifiedAt": null,
    "requestedDisclosures": {
      "name": true,
      "nationality": true,
      "date_of_birth": true,
      "issuing_state": false,
      "passport_number": false,
      "gender": false,
      "expiry_date": false
    },
    "verifiedData": null
  }
}

​
What This Endpoint Does

1

Session Lookup

Searches for identity verification session by wallet address
2

Status Check

Returns current verification status (pending, verified, failed, expired)
3

Data Retrieval

Provides verified identity data if verification is complete
4

Metadata Response

Returns session timestamps and requested disclosure fields

​
Status Meanings

​
Use Cases

Status Polling

Check if a user has completed their identity verification process

Data Retrieval

Retrieve verified identity data after successful verification

Session Management

Monitor session expiration and handle failed verifications

Integration Flow

Build verification status into your application’s user interface

​
Integration Tips

Polling Strategy: For real-time status updates, poll this endpoint periodically (every 30-60 seconds) while verification is pending.
Data Privacy: Verified data is only returned when the session status is ‘verified’. All other statuses return verifiedData: null.
Session Lifecycle: Sessions expire after 24 hours. Check the expiresAt timestamp to determine if a new verification session needs to be created.

Path Parameters

​
walletAddress
string
required

Valid Solana wallet address (Base58 format) to check verification status for

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

Response

200
application/json

Identity session retrieved successfully

The response is of type object.