Skip to main content
GET
List all suppliers

Authorizations

Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
per_page
integer
default:50

Items per page

Required range: 1 <= x <= 100

Search in name, CUI, email

country
string

Filter by country code

is_vat_payer
enum<integer>

Filter by VAT payer status

Available options:
0,
1
has_expenses
boolean

Only suppliers with expenses

sort
enum<string>
default:name

Sort field

Available options:
name,
created_at,
usage
order
enum<string>
default:asc

Sort order

Available options:
asc,
desc
expand
string

Comma-separated list (statistics,recent_expenses)

with_totals
enum<integer>

When 1, attaches a metadata object to each supplier with expense_count, total_expenses, and unpaid_total computed via inline subqueries (avoids N+1). Cheaper than expand=statistics.

Available options:
0,
1

Response

List of suppliers

success
boolean
data
object
meta
object