Invoices

Get invoice statistics

Returns aggregate KPIs for the company: counts by status, revenue, pending and overdue totals, average days to payment, and corrective counts. Filterable by period (defaults to the current year).

get/companies/{company}/invoices/stats

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/invoices/stats
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Query parameters

date_fromstring date nullable

Start of the period, by issue date (YYYY-MM-DD, inclusive).

date_tostring date nullable

End of the period, by issue date (YYYY-MM-DD, inclusive).

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": {
    "object": "invoice_stats",
    "total_count": 184,
    "by_status": {
      "draft": 12,
      "issued": 55,
      "paid": 108,
      "overdue": 6,
      "cancelled": 3
    },
    "revenue_total": "248750.45",
    "pending_amount": "18420.00",
    "overdue_count": 6,
    "overdue_amount": "7260.00",
    "average_payment_days": 23.5,
    "corrective_count": 4,
    "period": {
      "from": "2026-01-01",
      "to": "2026-03-31"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.