GET
/
invoices
curl https://api.contazen.ro/v1/invoices \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "inv_9z8y7x6w5v",
        "object": "invoice",
        "number": "CTZ-2024-00123",
        "document_type": "fiscal",
        "date": "2024-03-15",
        "due_date": "2024-04-15",
        "client_id": "1a2b3c4d5e",
        "subtotal": 1000.00,
        "vat_amount": 190.00,
        "total": 1190.00,
        "currency": "RON",
        "is_paid": false,
        "observations": "Payment terms: 30 days",
        "created_at": 1710460800,
        "updated_at": 1710460800
      },
      {
        "id": "inv_5f6g7h8i9j",
        "object": "invoice",
        "number": "CTZ-2024-00122",
        "document_type": "fiscal",
        "date": "2024-03-14",
        "due_date": "2024-04-14",
        "client_id": "9z8y7x6w5v",
        "subtotal": 500.00,
        "vat_amount": 95.00,
        "total": 595.00,
        "currency": "RON",
        "is_paid": true,
        "observations": null,
        "created_at": 1710374400,
        "updated_at": 1710460800
      }
    ],
    "has_more": true,
    "total": 156,
    "page": 1,
    "per_page": 50,
    "total_pages": 4
  },
  "meta": {
    "version": "v1",
    "response_time": "45.23ms"
  }
}

​
Request

​
page
integer
default:"1"
Page number to retrieve
​
per_page
integer
default:"50"
Number of items per page (max: 100)
​
client_id
string
Filter by client ID
​
series_id
string
Filter by invoice series ID
​
document_type
string
Filter by document typeOptions:
  • fiscal - Fiscal invoice
  • proforma - Proforma invoice
​
status
string
Filter by invoice statusOptions:
  • draft - Draft invoices only
  • issued - Issued but unpaid invoices (excludes voided)
  • paid - Paid invoices only (excludes voided)
  • overdue - Overdue unpaid invoices (excludes voided)
  • voided - Voided/cancelled invoices only
Default behavior: When no status filter is specified, all invoices are returned including voided ones. Voided invoices will have status: "voided" in the response.
Deleted invoices are completely removed from the database and never appear in any list results.
​
currency
string
Filter by currency code (e.g., RON, EUR, USD)
​
is_paid
integer
Filter by payment statusOptions:
  • 0 - Unpaid invoices
  • 1 - Paid invoices
​
start_date
string
Filter by start date (format: YYYY-MM-DD)
​
end_date
string
Filter by end date (format: YYYY-MM-DD)
​
sort
string
default:"created_at"
Field to sort byOptions:
  • created_at - Creation date
  • date - Invoice date
  • due_date - Due date
  • total - Total amount
  • number - Invoice number
​
order
string
default:"desc"
Sort order. Options: asc, desc
​
expand[]
array
Expand nested objects. See Expanding Objects for details.Available expansions:
  • lines - Invoice line items
  • payments - Payment records
  • client - Client details
  • efactura - E-Factura submission info

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
​
meta
object
Response metadata including version and response time
curl https://api.contazen.ro/v1/invoices \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "inv_9z8y7x6w5v",
        "object": "invoice",
        "number": "CTZ-2024-00123",
        "document_type": "fiscal",
        "date": "2024-03-15",
        "due_date": "2024-04-15",
        "client_id": "1a2b3c4d5e",
        "subtotal": 1000.00,
        "vat_amount": 190.00,
        "total": 1190.00,
        "currency": "RON",
        "is_paid": false,
        "observations": "Payment terms: 30 days",
        "created_at": 1710460800,
        "updated_at": 1710460800
      },
      {
        "id": "inv_5f6g7h8i9j",
        "object": "invoice",
        "number": "CTZ-2024-00122",
        "document_type": "fiscal",
        "date": "2024-03-14",
        "due_date": "2024-04-14",
        "client_id": "9z8y7x6w5v",
        "subtotal": 500.00,
        "vat_amount": 95.00,
        "total": 595.00,
        "currency": "RON",
        "is_paid": true,
        "observations": null,
        "created_at": 1710374400,
        "updated_at": 1710460800
      }
    ],
    "has_more": true,
    "total": 156,
    "page": 1,
    "per_page": 50,
    "total_pages": 4
  },
  "meta": {
    "version": "v1",
    "response_time": "45.23ms"
  }
}