Skip to main content
GET
/
supplier-bills
/
{id}
Get supplier bill
curl --request GET \
  --url https://api.contazen.ro/v1/supplier-bills/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "supplier_bill": {
      "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": [
        {}
      ],
      "supplier_balance": {
        "unpaid_total": 123,
        "unpaid_count": 123,
        "currency": "<string>",
        "next_due": {
          "id": "<string>",
          "invoice_number": "<string>",
          "due_date": "2023-12-25",
          "tax_inclusive": 123
        }
      }
    }
  },
  "meta": {
    "version": "v1",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "response_time": "23.45ms"
  }
}

Overview

Returns one supplier bill by its CzUid. The response includes a supplier_balance block aggregating the supplier’s outstanding invoices across all your work points, plus the next due invoice (if any).

Default expansions

The detail endpoint expands supplier, expense, client, efactura_message, and lines by default. Pass expand= (empty) to skip all expansions, or expand=supplier,lines to choose a subset.

Authorizations

Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Path Parameters

id
string
required

Supplier bill CzUid.

Query Parameters

expand
string

Defaults to supplier,expense,client,efactura_message,lines.

Response

Supplier bill detail (with supplier_balance block)

success
boolean
data
object
meta
object