GET
/
suppliers
List all suppliers
curl --request GET \
  --url https://api.contazen.ro/v1/suppliers \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "object": "list",
    "has_more": true,
    "total": 123,
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "data": [
      {
        "id": "sup_1a2b3c4d5e",
        "name": "<string>",
        "cui": "<string>",
        "rc": "<string>",
        "cnp": "<string>",
        "address": "<string>",
        "city": "<string>",
        "county": "<string>",
        "country": "<string>",
        "postal_code": "<string>",
        "phone": "<string>",
        "email": "<string>",
        "iban": "<string>",
        "bank": "<string>",
        "contact_person": "<string>",
        "contact_phone": "<string>",
        "contact_email": "<string>",
        "is_vat_payer": true,
        "statistics": {
          "expense_count": 123,
          "total_amount": 123,
          "paid_amount": 123,
          "unpaid_amount": 123
        },
        "recent_expenses": [
          {
            "id": "<string>",
            "reference": "<string>",
            "amount": 123,
            "currency": "<string>",
            "date": "2023-12-25",
            "is_paid": true
          }
        ],
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ]
  },
  "meta": {
    "version": "v1",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "response_time": "23.45ms"
  }
}

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)

Response

List of suppliers

success
boolean
data
object
meta
object