Skip to main content
GET
List purchase orders

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

Single canonical status, comma-separated multi-value, or all. Accepts canonical order_status ENUM values and 5 legacy aliases (translated server-side).

Example:

"open,processing"

vendor_id
string<uuid>

UUID of the vendor account. Canonical filter name.

account_id
string<uuid>

Legacy alias for vendor_id. Vendor records are account rows so both keys refer to the same vendor account UUID. If both are provided with different values, vendor_id wins and a server-side warning is logged. New integrations SHOULD use vendor_id.

limit
integer
default:25
Required range: x <= 100
starting_after
string
expand[]
enum<string>[]
Available options:
data.line_items,
data.line_items.product,
data.vendor,
data.receipts,
data.bills

Response

Paginated list of purchase orders

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