List reports

GET

/api/v1/reports

Docs menu

Your reports, newest first.

Key
Bearer key, test or live
Scope
read

Parameters

limitintegeroptional

How many objects to return, 1 to 100. Default 20.

Default: 20

starting_afterstringoptional

The id of the last object you have. Returns the objects after it. Newest first.

Response

200. A page of reports.

objectstring

list

dataarray of object
Show child fields
idstring

rep_...

objectstring

report

livemodeboolean
check_idstring
datedstring

The check's completed_at.

brandobject
statusstring

readyrevoked

share_urlstring or null
pdfobject
sampleboolean

True for every test-mode report: a marked sample, not a proof report.

record_codestring or null

The record code printed on a live report, like PP-7K3M-9QX2-4T8F. Anyone holding it can check the report is genuine at /verify. Null in test mode.

record_urlstring or null

The public page that checks the record code: /verify/<record_code>. Null when record_code is null.

verify_lineboolean

Whether the printed report carries the line "Record <code> · Check it is genuine at pressprove.com/verify · Fingerprint". When false the report names nothing of PressProve; the record still exists and record_code still checks.

credits_chargedinteger
created_atstring
project_idstring or null

The client project it is tagged to, in the same workspace; null when none.

has_moreboolean
next_starting_afterstring or null

Pass this as starting_after to read the next page.

Errors

CodeStatusMeaning
missing_scope403The API key does not have the scope this endpoint needs.
limit_invalid400The limit must be a whole number from 1 to 100.
cursor_invalid400The starting_after cursor does not name an object in this list.

Any request can also fail with missing_api_key, invalid_api_key, api_key_revoked, rate_limited or internal_error. See Errors.

In test mode