Skip to main content
GET
/
invoices
List all invoices
curl --request GET \
  --url https://api.contazen.ro/v1/invoices \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "object": "list",
    "has_more": true,
    "total": 123,
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "data": [
      {
        "id": "inv_1a2b3c4d5e",
        "object": "invoice",
        "number": "<string>",
        "series": "<string>",
        "full_number": "<string>",
        "date": "2023-12-25",
        "due_date": "2023-12-25",
        "client_id": "<string>",
        "client": {
          "id": "cli_1a2b3c4d5e",
          "object": "client",
          "name": "<string>",
          "type": "company",
          "email": "jsmith@example.com",
          "phone": "<string>",
          "cui": "<string>",
          "cui_prefix": "RO",
          "rc": "<string>",
          "address": "<string>",
          "city": "<string>",
          "county": "<string>",
          "country": "RO",
          "postal_code": "<string>",
          "iban": "<string>",
          "bank_name": "<string>",
          "contact_person": "<string>",
          "notes": "<string>",
          "is_active": true,
          "is_firm": true,
          "created_at": "2023-11-07T05:31:56Z",
          "modified_at": "2023-11-07T05:31:56Z"
        },
        "currency": "RON",
        "exchange_rate": 123,
        "subtotal": 123,
        "vat_amount": 123,
        "total": 123,
        "subtotal_ron": 123,
        "vat_amount_ron": 123,
        "total_ron": 123,
        "items": [
          {
            "id": 123,
            "product_id": "<string>",
            "description": "<string>",
            "description_extended": "<string>",
            "quantity": 123,
            "price": 123,
            "vat_rate": 19,
            "vat_key": 123,
            "unit": "buc",
            "ubl_um": "H87",
            "ubl_nc": "<string>",
            "ubl_cpv": "<string>",
            "subtotal": 123,
            "vat_amount": 123,
            "total": 123,
            "save_as_product": true
          }
        ],
        "payments": [
          {
            "id": "<string>",
            "amount": 123,
            "payment_date": "2023-12-25",
            "payment_method": "<string>",
            "observations": "<string>",
            "created_at": "2023-11-07T05:31:56Z"
          }
        ],
        "is_paid": true,
        "paid_at": "2023-12-25",
        "is_void": true,
        "voided_at": "2023-11-07T05:31:56Z",
        "void_reason": "<string>",
        "is_draft": true,
        "is_storno": true,
        "storno_for": "<string>",
        "document_type": "fiscal",
        "payment_method": "<string>",
        "notes": "<string>",
        "observations": "<string>",
        "efactura_enabled": true,
        "efactura_status": "pending",
        "efactura_submission_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "modified_at": "2023-11-07T05:31:56Z"
      }
    ],
    "totals": {
      "subtotal": 1380871.63,
      "vat": 192519.84,
      "total": 1573391.47,
      "paid": 1450000,
      "unpaid": 123391.47
    }
  },
  "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
​
client_id
string

Filter by client CzUid

​
series_id
string

Filter by series CzUid

​
is_paid
enum<integer>

Filter by payment status (0=unpaid, 1=paid). Note: This filter excludes voided and storno invoices.

Available options:
0,
1
​
is_void
enum<integer>

Filter by void status

Available options:
0,
1
​
document_type
enum<string>

Filter by document type

Available options:
fiscal,
proforma,
receipt
​
status
enum<string>

Filter by status

Available options:
draft,
sent,
paid,
overdue,
cancelled
​
currency
string

Filter by currency code (e.g., RON, EUR, USD)

​
start_date
string<date>

Start date (YYYY-MM-DD)

​
end_date
string<date>

End date (YYYY-MM-DD)

​
sort
enum<string>
default:created_at

Sort field

Available options:
created_at,
date,
due_date,
total,
number
​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
expand[]
enum<string>[]

Expand nested objects

Response

List of invoices

​
success
boolean
​
data
object
​
meta
object