Documentation version: Latest (v1)
API endpoint
List backend OTP verifications
Paginated verification history for server OTP keys.
GET/api/v1/backend-otp/verifications?limit=50
Auth: Bearer API key with server_otp scope
Required headers
| Header | Required | Value | Description |
|---|---|---|---|
| Authorization | Yes | Bearer <token> | API key, server OTP key, or public OTP token depending on endpoint. |
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Default 50, max 100. |
Code examples (all supported languages)
Snippets use placeholder tokens. Replace them with real credentials from your dashboard.
curl -X GET "https://risumail.risu.in/api/v1/backend-otp/verifications?limit=50" \
-H "Authorization: Bearer YOUR_SERVER_OTP_KEY"Response schema
Canonical schema inferred from the documented success payload. Copy this block when generating typed clients.
{
"type": "object",
"required": [
"success",
"data"
],
"properties": {
"success": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"verifications"
],
"properties": {
"verifications": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"email",
"sentAt",
"verifiedAt"
],
"properties": {
"id": {
"type": "string"
},
"email": {
"type": "string"
},
"sentAt": {
"type": "string"
},
"verifiedAt": {
"type": "string"
}
}
}
}
}
}
}
}Success response example
{
"success": true,
"data": {
"verifications": [
{
"id": "otp_backend_01J...",
"email": "user@example.com",
"sentAt": "2026-04-19T11:45:00.000Z",
"verifiedAt": "2026-04-19T11:45:20.000Z"
}
]
}
}Common error cases
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | API key missing or invalid. |
| 403 | SCOPE_REQUIRED | Missing server_otp scope. |
Implementation notes
- Use for audit trails, anti-abuse checks, and support console timelines.