Skip to main content
GET
/
supplier-bills
List supplier bills
curl --request GET \
  --url https://api.contazen.ro/v1/supplier-bills \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "object": "list",
    "has_more": true,
    "total": 123,
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "data": [
      {
        "id": "<string>",
        "object": "supplier_bill",
        "invoice_number": "<string>",
        "invoice_type_code": "380",
        "invoice_type": "invoice",
        "issue_date": "2023-12-25",
        "due_date": "2023-12-25",
        "currency": "RON",
        "amounts": {
          "tax_exclusive": 123,
          "tax": 123,
          "tax_inclusive": 123,
          "paid": 123,
          "unpaid": 123
        },
        "status": "unpaid",
        "payment_date": "2023-12-25",
        "payment_amount": 123,
        "supplier": {
          "id": "<string>",
          "name": "<string>",
          "vat_id": "<string>",
          "reg_com": "<string>",
          "address": "<string>",
          "email": "<string>",
          "phone": "<string>"
        },
        "supplier_id": "<string>",
        "expense_id": "<string>",
        "client_id": "<string>",
        "efactura_message_id": 123,
        "efactura_pdf_url": "<string>",
        "order_reference": "<string>",
        "note": "<string>",
        "created_at": 123,
        "updated_at": 123,
        "expense": {},
        "client": {},
        "efactura_message": {
          "id": 123,
          "message_id": "<string>",
          "cif": "<string>",
          "type": "<string>",
          "creation_date": "2023-11-07T05:31:56Z",
          "environment": "test"
        },
        "lines": [
          {}
        ]
      }
    ],
    "totals": {
      "count": 123,
      "tax_exclusive": 123,
      "tax": 123,
      "tax_inclusive": 123,
      "paid": 123,
      "unpaid": 123,
      "by_currency": {}
    }
  },
  "meta": {
    "version": "v1",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "response_time": "23.45ms"
  }
}

​
Overview

Returns the supplier invoices that Contazen has imported from your ANAF SPV inbox. This is the API equivalent of the Facturi primite de la furnizori view in the web app. Results span every work point under your parent company. Use the filter parameters to narrow by status, date range, supplier (CIF or name), or currency.

​
Totals

The response includes a totals block with both global aggregates (count, tax-exclusive, tax, tax-inclusive, paid, unpaid) and a by_currency breakdown — supplier bills frequently mix RON with foreign currencies and summing across them produces meaningless numbers.

​
Reciprocal client

When a row’s supplier CIF matches one of your firm’s clients, client_id is populated with that client’s CzUid. This makes it easy to surface a “your supplier is also your client” hint in the UI.

Authorizations

​
Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
per_page
integer
default:25
Required range: 1 <= x <= 100
​
status
enum<string>
Available options:
unpaid,
paid,
partial
​
supplier
string

Search by supplier name or VAT id (LIKE).

​
search
string

Alias of supplier — search by CIF or supplier name.

​
supplier_id
string

Filter by supplier CzUid.

​
currency
string
​
invoice_type_code
enum<string>

380 = invoice, 381 = credit note.

Available options:
380,
381
​
start_date
string<date>
​
end_date
string<date>
​
sort
enum<string>
default:issue_date
Available options:
issue_date,
due_date,
total,
invoice_number,
created_at
​
order
enum<string>
default:desc
Available options:
asc,
desc
​
expand
string

Comma-separated list of relations to expand. Supported: supplier, expense, client, efactura_message, lines.

Response

List of supplier bills

​
success
boolean
​
data
object
​
meta
object