Contazen API Documentation

curl -X GET https://api.contazen.ro/v1/invoices/stats \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -G -d "year=2024"

{
  "success": true,
  "data": {
    "overview": {
      "total_invoices": 245,
      "total_revenue": 458750.00,
      "average_invoice_value": 1872.45,
      "payment_rate": 87.5
    },
    "by_status": {
      "draft": 5,
      "sent": 25,
      "paid": 195,
      "overdue": 15,
      "cancelled": 5
    },
    "monthly_trend": [
      {
        "month": "January",
        "month_number": 1,
        "total": 35000.00,
        "count": 18,
        "growth": 0
      },
      {
        "month": "February",
        "month_number": 2,
        "total": 42000.00,
        "count": 22,
        "growth": 20.0
      }
    ],
    "top_clients": [
      {
        "client_id": "cli_abc123def",
        "client_name": "Tech Solutions SRL",
        "total_revenue": 85000.00,
        "invoice_count": 12,
        "percentage": 18.5
      }
    ],
    "by_currency": [
      {
        "currency": "RON",
        "total": 385000.00,
        "total_ron": 385000.00,
        "count": 210
      },
      {
        "currency": "EUR",
        "total": 15000.00,
        "total_ron": 73750.00,
        "count": 35
      }
    ],
    "payment_methods": {
      "bank_transfer": 165,
      "cash": 20,
      "card": 10,
      "other": 0
    }
  }
}

GET

invoices

stats

curl -X GET https://api.contazen.ro/v1/invoices/stats \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -G -d "year=2024"

{
  "success": true,
  "data": {
    "overview": {
      "total_invoices": 245,
      "total_revenue": 458750.00,
      "average_invoice_value": 1872.45,
      "payment_rate": 87.5
    },
    "by_status": {
      "draft": 5,
      "sent": 25,
      "paid": 195,
      "overdue": 15,
      "cancelled": 5
    },
    "monthly_trend": [
      {
        "month": "January",
        "month_number": 1,
        "total": 35000.00,
        "count": 18,
        "growth": 0
      },
      {
        "month": "February",
        "month_number": 2,
        "total": 42000.00,
        "count": 22,
        "growth": 20.0
      }
    ],
    "top_clients": [
      {
        "client_id": "cli_abc123def",
        "client_name": "Tech Solutions SRL",
        "total_revenue": 85000.00,
        "invoice_count": 12,
        "percentage": 18.5
      }
    ],
    "by_currency": [
      {
        "currency": "RON",
        "total": 385000.00,
        "total_ron": 385000.00,
        "count": 210
      },
      {
        "currency": "EUR",
        "total": 15000.00,
        "total_ron": 73750.00,
        "count": 35
      }
    ],
    "payment_methods": {
      "bank_transfer": 165,
      "cash": 20,
      "card": 10,
      "other": 0
    }
  }
}

Overview

This endpoint provides detailed invoice statistics including counts by status, monthly trends, top clients, and revenue breakdown. Perfect for dashboards and analytics.

Query Parameters

integer

Year for statistics (defaults to current year)

integer

Specific month (1-12) for detailed monthly statistics

integer

Specific quarter (1-4) for quarterly statistics

string

Filter statistics by specific currency

Response

boolean

Indicates if the request was successful

object

Show properties

object

Overall statistics summary

Show properties

integer

Total number of invoices

number

Total revenue across all currencies (in RON)

number

Average invoice value

number

Percentage of invoices paid (0-100)

object

Invoice counts by status

Show properties

integer

Number of draft invoices

integer

Number of sent invoices

integer

Number of paid invoices

integer

Number of overdue invoices

integer

Number of cancelled/voided invoices

array

Monthly revenue trend

Show properties

string

Month name

integer

Month number (1-12)

number

Total revenue for the month

integer

Number of invoices for the month

number

Percentage growth from previous month

array

Top 10 clients by revenue

Show properties

string

Client CzUid

string

Client name

number

Total revenue from this client

integer

Number of invoices for this client

number

Percentage of total revenue

array

Revenue breakdown by currency

Show properties

string

Currency code

number

Total amount in this currency

number

Total converted to RON

integer

Number of invoices

object

Breakdown by payment method

Show properties

integer

Number of bank transfer payments

integer

Number of cash payments

integer

Number of card payments

integer

Number of other payment methods

curl -X GET https://api.contazen.ro/v1/invoices/stats \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -G -d "year=2024"

{
  "success": true,
  "data": {
    "overview": {
      "total_invoices": 245,
      "total_revenue": 458750.00,
      "average_invoice_value": 1872.45,
      "payment_rate": 87.5
    },
    "by_status": {
      "draft": 5,
      "sent": 25,
      "paid": 195,
      "overdue": 15,
      "cancelled": 5
    },
    "monthly_trend": [
      {
        "month": "January",
        "month_number": 1,
        "total": 35000.00,
        "count": 18,
        "growth": 0
      },
      {
        "month": "February",
        "month_number": 2,
        "total": 42000.00,
        "count": 22,
        "growth": 20.0
      }
    ],
    "top_clients": [
      {
        "client_id": "cli_abc123def",
        "client_name": "Tech Solutions SRL",
        "total_revenue": 85000.00,
        "invoice_count": 12,
        "percentage": 18.5
      }
    ],
    "by_currency": [
      {
        "currency": "RON",
        "total": 385000.00,
        "total_ron": 385000.00,
        "count": 210
      },
      {
        "currency": "EUR",
        "total": 15000.00,
        "total_ron": 73750.00,
        "count": 35
      }
    ],
    "payment_methods": {
      "bank_transfer": 165,
      "cash": 20,
      "card": 10,
      "other": 0
    }
  }
}

API Reference

Get Invoice Statistics

Overview

Query Parameters

Response

​Overview

​Query Parameters

​Response

Overview

Query Parameters

Response