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

string

required

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

string

required

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

string

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

string

Filter totals by specific client using their CzUid

string

Filter totals by specific invoice series using its CzUid

integer

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

string

Filter by document type (fiscal or proforma)

Response

boolean

Indicates if the request was successful

object

Show properties

array

Array of total objects grouped by currency

Show properties

string

Currency code

number

Total invoice amount in this currency

number

Total amount paid in this currency

number

Total amount unpaid in this currency

number

Total VAT amount in this currency

integer

Number of invoices in this currency

integer

Number of paid invoices in this currency

integer

Number of unpaid invoices in this currency

object

Show properties

string

Start date of the period

string

End date of the period

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
  }
}

API Reference

Get Invoice Totals

Overview

Query Parameters

Response

​Overview

​Query Parameters

​Response

Overview

Query Parameters

Response