Skip to main content
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

The verification session has been created but the user has not yet completed identity verification using the Self.xyz app. The session is still active and can be completed.
The user has successfully completed identity verification. The verifiedData object will contain the actual verified identity information that was requested.
The identity verification failed due to invalid documents, failed verification checks, or other Self.xyz validation issues.
The verification session expired (after 24 hours) before the user completed verification. A new session must be created to attempt verification again.

​
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

Identity session retrieved successfully

​
message
string
required

Confirmation that the session was retrieved successfully

​
details
object
required
⌘I