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 for the period in YYYY-MM-DD format
End date for the period in YYYY-MM-DD format
Filter totals by specific currency code (e.g., RON, EUR, USD)
Filter totals by specific client using their CzUid
Filter totals by specific invoice series using its CzUid
Filter by payment status (0 for unpaid, 1 for paid)
Filter by document type (fiscal or proforma)
Response
Indicates if the request was successful
Array of total objects grouped by currency Total invoice amount in this currency
Total amount paid in this currency
Total amount unpaid in this currency
Total VAT amount in this currency
Number of invoices in this currency
Number of paid invoices in this currency
Number of unpaid invoices in this currency
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
}
}