Skip to main content
GET
List vendor bills

Authorizations

Authorization
string
header
required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

Query Parameters

status
string
vendor_id
string<uuid>
limit
integer
default:25
Required range: x <= 100
starting_after
string
created_after
string<date-time>

Filter bills created on or after this timestamp (ISO 8601).

created_before
string<date-time>

Filter bills created on or before this timestamp (ISO 8601).

due_before
string<date>

Filter bills with due_date on or before this date (ISO 8601 date). Pass today's date to get overdue bills only, or today + N days for the "due in N days" window.

expand[]
enum<string>[]
Available options:
data.lines,
data.lines.product,
data.payments,
data.gl_entries,
data.vendor,
data.purchase_order

Response

Paginated list of vendor bills

object
enum<string>
Available options:
list
data
object[]
has_more
boolean