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
}
}
Invoices
Get Invoice Totals
Get aggregated invoice totals for a specific period
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
Show properties
array
Array of total objects grouped by currency
Show properties
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
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
}
}
Was this page helpful?