Skip to main content
List invoice imports

Authorizations

Authorization
string
header
required

Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Query Parameters

limit
integer
default:50

Maximum number of results per page.

Required range: 1 <= x <= 100
cursor
string

Opaque next_cursor from the previous page. Keep the same filters and sort; omit for the first page.

Maximum string length: 4096
status
string
Maximum string length: 4000
outcome
string
Maximum string length: 4000
origin
string

How the source entered: upload, api, email or integration.

Maximum string length: 4000
file_name
string
Maximum string length: 255
created_from
string<date-time>
Maximum string length: 27
created_before
string<date-time>
Maximum string length: 27
sort
enum<string>
default:created_at
Available options:
created_at,
updated_at,
primary_file_name
order
enum<string>
default:desc
Available options:
asc,
desc
deleted
enum<string>
default:false
Available options:
true,
false

Response

A page of import summaries; next_cursor is null at the end.

data
object[]
required
Maximum array length: 100
next_cursor
string | null
required
total
integer
required
failed_retryable_count
integer
required
has_ingestion
boolean
required

Organization-wide presence of retained Imports, invoice rows of any status (including deleted legacy rows), or invoice-category Documents. Independent of status filters and pagination. An empty data page can still have has_ingestion=true. Permanent removal of all evidence cannot prove past uploads.