Get session status

Poll for session status (use for long-polling).

get/api/v1/sessions/{id}

Request

Base URL: https://api.proof.holdings
URL: https://api.proof.holdings/api/v1/sessions/{id}
Auth: HTTP bearer

Path parameters

idstring required

MongoDB ObjectId

Example:507f1f77bcf86cd799439011

Response

Session status

idstring required

MongoDB ObjectId

status'pending' | 'verified' | 'expired' required

created_atstring date-time required

expires_atstring date-time required

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "challenge": {
    "code": "X7K2M9",
    "instruction": "Send X7K2M9 to +370 691 99199 on WhatsApp",
    "expires_at": "2026-02-13T12:00:00Z"
  },
  "proof": {
    "token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expires_at": "2025-01-15T12:00:00Z",
    "confidence": "high"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.