reports

List reported mail

Every message forwarded to the report mailbox, read back from Gmail's Alert Center, or filed with the Fallax button in Gmail. verdict is simulation when the message was matched to something Fallax sent, and unknown when it matched nothing, which is the pile of real suspicious mail worth triaging.

get/reports

Request

  • Base URL: https://api.fallax.io/v1
  • URL: https://api.fallax.io/v1/reports
  • Auth: HTTP bearer

Query parameters

limitstring

Rows per page, 1 to 200. Defaults to 50. A page comes back with a nextCursor when there are more.

Example:50
cursorstring

The nextCursor from the previous page. Paging is by cursor rather than by offset, so rows written while you page are never skipped.

sincestring

Only rows after this instant, exclusive. ISO 8601 or epoch milliseconds. This is the parameter a poll trigger uses: pass the timestamp of the newest row you have already handled.

Example:2026-09-07T12:00:00Z
order'desc' | 'asc'

desc (the default) for newest first, which is what a person reading a page wants. asc for oldest first, which is what anything resuming from a watermark wants: with since and a limit, an ascending page is the oldest rows you have not seen, so a backlog drains in order instead of the newest page hiding the rest.

verdict'simulation' | 'unknown'

simulation or unknown. Omit for both.

credited'true' | 'false'

true to return only the report that credited a person for reporting, rather than every copy of it.

Response

List reported mail

nextCursorstring nullable required

Pass as cursor for the next page.

hasMoreboolean required

Changes

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