Skip to main content
GET
List (and search) tenant verifications, newest first

Authorizations

rial_session
string
cookie
required

Dashboard / operator session cookie. Set by /v1/auth/google/callback after Google OAuth, JWT signed with the rotating rial-platform/session-signing HMAC. Read on every request the SPA makes with credentials: include. Browser-only — server-to-server callers use bearerApiKey instead.

Query Parameters

limit
integer

Soft cap; adapters may return fewer.

Required range: 1 <= x <= 100
Example:

20

cursor
string

Opaque cursor from a previous response. Treat as a black box.

status
enum<string>

Exact match on verification status.

Available options:
pending,
partially_captured,
completed,
expired,
failed,
abandoned
verdict
enum<string>

Exact match on verdict.label. Pending verifications never match.

Available options:
verified,
suspicious,
failed
reason_code
enum<string>

Exact match on verdict.reason_code. Verifications with no verdict, or a verified verdict, never match.

Available options:
screen_detected,
ai_generated,
context_mismatch,
reverse_search_match,
depth_anomaly
from
string

Inclusive lower bound on created_at. ISO 8601 date or date-time.

Example:

"2026-07-01T00:00:00.000Z"

to
string

Inclusive upper bound on created_at. ISO 8601 date or date-time.

Example:

"2026-07-31T23:59:59.999Z"

metadata.<key>
string

Exact match against config.metadata[<key>]. Repeatable with different keys (ANDed). Literal param name is metadata. followed by the metadata key, e.g. metadata.client_label=estancia-la-julia.

Example:

"estancia-la-julia"

caravana
string

Exact match against ocr.primary of any capture on the verification.

Example:

"AB123CD"

Response

A page of verifications matching the filters. next_cursor absent means no more pages.

items
object[]
required

Array of Verification objects.

next_cursor
string