Contazen API Documentation

curl -X GET https://api.contazen.ro/v1/invoices/totals \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -G -d "start_date=2024-01-01" \
  -d "end_date=2024-12-31"

{
  "success": true,
  "data": {
    "totals": [
      {
        "currency": "RON",
        "total_amount": 125000.00,
        "total_paid": 95000.00,
        "total_unpaid": 30000.00,
        "total_vat": 21000.00,
        "invoice_count": 45,
        "paid_count": 35,
        "unpaid_count": 10
      },
      {
        "currency": "EUR",
        "total_amount": 15000.00,
        "total_paid": 12000.00,
        "total_unpaid": 3000.00,
        "total_vat": 2520.00,
        "invoice_count": 8,
        "paid_count": 6,
        "unpaid_count": 2
      }
    ],
    "period": {
      "start_date": "2024-01-01",
      "end_date": "2024-12-31"
    },
    "grand_total_ron": 199575.00
  }
}

GET

invoices

totals

curl -X GET https://api.contazen.ro/v1/invoices/totals \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -G -d "start_date=2024-01-01" \
  -d "end_date=2024-12-31"

{
  "success": true,
  "data": {
    "totals": [
      {
        "currency": "RON",
        "total_amount": 125000.00,
        "total_paid": 95000.00,
        "total_unpaid": 30000.00,
        "total_vat": 21000.00,
        "invoice_count": 45,
        "paid_count": 35,
        "unpaid_count": 10
      },
      {
        "currency": "EUR",
        "total_amount": 15000.00,
        "total_paid": 12000.00,
        "total_unpaid": 3000.00,
        "total_vat": 2520.00,
        "invoice_count": 8,
        "paid_count": 6,
        "unpaid_count": 2
      }
    ],
    "period": {
      "start_date": "2024-01-01",
      "end_date": "2024-12-31"
    },
    "grand_total_ron": 199575.00
  }
}

Overview

This endpoint returns aggregated invoice totals for a specific date range. The totals are grouped by currency and payment status, providing a comprehensive overview of your invoicing metrics.

Query Parameters

start_date

string

required

Start date for the period in YYYY-MM-DD format

end_date

string

required

End date for the period in YYYY-MM-DD format

currency

string

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

client_id

string

Filter totals by specific client using their CzUid

series_id

string

Filter totals by specific invoice series using its CzUid

is_paid

integer

Filter by payment status (0 for unpaid, 1 for paid)

document_type

string

Filter by document type (fiscal or proforma)

Response

success

boolean

Indicates if the request was successful

data

object

Show properties

totals

array

Array of total objects grouped by currency

Show properties

currency

string

Currency code

total_amount

number

Total invoice amount in this currency

total_paid

number

Total amount paid in this currency

total_unpaid

number

Total amount unpaid in this currency

total_vat

number

Total VAT amount in this currency

invoice_count

integer

Number of invoices in this currency

paid_count

integer

Number of paid invoices in this currency

unpaid_count

integer

Number of unpaid invoices in this currency

period

object

Show properties

start_date

string

Start date of the period

end_date

string

End date of the period

grand_total_ron

number

Grand total converted to RON using current exchange rates

curl -X GET https://api.contazen.ro/v1/invoices/totals \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -G -d "start_date=2024-01-01" \
  -d "end_date=2024-12-31"

{
  "success": true,
  "data": {
    "totals": [
      {
        "currency": "RON",
        "total_amount": 125000.00,
        "total_paid": 95000.00,
        "total_unpaid": 30000.00,
        "total_vat": 21000.00,
        "invoice_count": 45,
        "paid_count": 35,
        "unpaid_count": 10
      },
      {
        "currency": "EUR",
        "total_amount": 15000.00,
        "total_paid": 12000.00,
        "total_unpaid": 3000.00,
        "total_vat": 2520.00,
        "invoice_count": 8,
        "paid_count": 6,
        "unpaid_count": 2
      }
    ],
    "period": {
      "start_date": "2024-01-01",
      "end_date": "2024-12-31"
    },
    "grand_total_ron": 199575.00
  }
}

Delete Invoice Get Invoice Statistics

API Reference

Get Invoice Totals

Overview

Query Parameters

Response

​Overview

​Query Parameters

​Response

Overview

Query Parameters

Response