Verifications

List Verifications

Retrieve a paginated list of photo authenticity verifications for your account.

This endpoint returns all verifications you've created, with powerful filtering and search capabilities. Each verification represents a comparison between a RAW photo file and its corresponding JPEG to determine authenticity.

Authentication Required: Valid API key or JWT token

Query Parameters:

  • offset: Start position for pagination (0-based index)
  • size: Number of results per page (1-100, default 20)
  • sort_by: Sort field - created_at (default), updated_at, or status
  • sort_order: asc or desc (default)
  • search: Find verifications by name, ID, photo hash, or tag name
  • status: Filter by processing status
  • result: Filter by authenticity outcome
  • tags: Filter by tag names (comma-separated); tag_match picks 'all' (default) or 'any'

Response: Returns a VerificationListResponse containing:

  • items: Array of verification objects with full details
  • total: Total number of verifications matching filters
  • offset: Current offset position
  • size: Number of items returned
  • total_pages: Total pages available

Example Use Cases:

  • Get all completed verifications: ?status=completed
  • Find authentic photos only: ?result=true&status=completed
  • Search by filename: ?search=wedding_photo.jpg
  • Everything tagged both 'client a' and 'wedding': ?tags=client a,wedding
  • Anything tagged 'invoice sent' or 'paid': ?tags=invoice sent,paid&tag_match=any
  • Recent verifications first: ?sort_by=created_at&sort_order=desc
get/v1/verifications/

Request

  • Base URL: https://api.lumethic.com
  • URL: https://api.lumethic.com/v1/verifications/
  • Auth: OAuth2PasswordBearer (a scheme the document does not define)

Query parameters

offsetinteger

Number of items to skip for pagination

sizeinteger

Number of items to return per page (max 100)

sort_bystring

Field to sort by: 'status', 'created_at', or 'updated_at'

sort_orderstring

Sort order: 'asc' for ascending or 'desc' for descending

searchstring nullable

Search by verification name, ID, or photo hash

statusstring nullable

Filter by verification status. Supports comma-separated values: 'pending', 'queued', 'in_progress', 'completed', or 'failed'. Example: 'pending,queued,in_progress'

resultstring nullable

Filter by authenticity result: 'true' for authentic images, 'false' for non-authentic

tagsstring nullable

Filter by tag names, comma-separated and case-insensitive (max 10). By default every listed tag must be on the verification; see tag_match. Example: 'client a,wedding'

tag_matchstring

How multiple tags combine: 'all' (default, every tag must match) or 'any' (at least one)

request_idstring uuid nullable

Only the records that answered this verification request (REQUEST_PATH_PLAN.md §3.4)

Headers

X-API-Keystring nullable

Response

Paginated list of verifications

totalinteger required

Total number of verifications matching the query

offsetinteger required

Current offset position in the result set

sizeinteger required

Number of items returned in this page

total_pagesinteger required

Total number of pages available

Changes

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