Skip to main content
GET
Python
Didit’s async Reports API lists export jobs you can read, newest first. Use failed_count and failed_item_ids to identify verification exports with individual failures. See export and retry guidance, retrieve one report, or retry an export.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

organization_id
string<uuid>
required

Organization id.

application_id
string<uuid>
required

Application id.

Query Parameters

limit
integer
default:50

Maximum results per page.

Required range: x >= 1
offset
integer
default:0

Number of results to skip.

Required range: x >= 0
status
string

Comma-separated or repeated status values: PENDING, PROCESSING, READY, FAILED.

report_type
string

Comma-separated or repeated report_type values.

q
string

Search by report ID fragment or requester name/email (at most 255 characters).

Response

List async reports.

count
integer
required

Result count, normally capped at 100; may be estimated. Follow next rather than using count to stop pagination.

next
string | null
required

Next page URL, or null.

previous
string | null
required

Previous page URL, or null.

results
object[]
required
counts
object
required

Counts of all reports the caller can read, before the list filters.

Last modified on November 14, 2026