Auth

Submit auth OTP code

Submit OTP code for email auth session. Rate limited: 10 requests per minute per IP.

post/api/v1/auth/sessions/{id}/submit

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/auth/sessions/{id}/submit
  • Auth: none declared

Path parameters

idstring required

Auth session ID

Example:auth_abc123

Request body

codestring required

OTP code for email auth

Example request

{
  "code": "123456"
}

Response

Code accepted

idstring required
type'login' required
channel'telegram' | 'whatsapp' | 'sms' | 'email' required

Authentication channel

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

Status of an auth session

deep_linkstring
qr_codestring

Base64-encoded QR code image

qr_textstring

UTF-8 text representation of the QR code for terminal/agent display

expires_atstring date-time required
instructionsstring
verified_atstring date-time
user_idstring

Example response

{
  "id": "auth_abc123",
  "channel": "telegram",
  "status": "pending",
  "deep_link": "https://t.me/bot?start=auth_abc123",
  "expires_at": "2026-02-13T12:10:00Z",
  "instructions": "Open Telegram and tap the link to log in"
}

Changes

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