---
title: "Financial summary"
method: GET
path: "/v1/summary"
tags: ["Summary"]
---

# Financial summary

`GET /v1/summary`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/summary`
- Auth: API key in header `X-API-Key`

Get an aggregated financial summary including revenue, expenses, profit,
entity counts, and invoice status breakdown. Supports optional date range filtering.

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

Financial summary

- Summary
  - `period` object
    - `from` string, date, nullable
    - `to` string, date, nullable
  - `revenue` object
    - `invoiced` number: Total invoiced amount
    - `paid` number: Total paid amount
    - `pending` number: Total pending (sent but unpaid)
    - `overdue` number: Total overdue amount
  - `expenses` object
    - `total` number: Total expenses
  - `profit` number: Net profit (paid revenue minus expenses)
  - `counts` object
    - `invoices` integer
    - `quotes` integer
    - `expenses` integer
    - `clients` integer
    - `products` integer
  - `invoicesByStatus` object
  - `overdue` object
    - `count` integer
    - `amount` number

## Other responses

- `400`: Bad request - invalid parameters or request body
- `401`: Authentication required or invalid API key
- `429`: Rate limit exceeded (100 requests per minute)
- `500`: Internal server error

---

[API](https://skmtc.dev/frihet/apis/frihet-api.md) · [All operations](https://skmtc.dev/frihet/apis/frihet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frihet/apis/frihet-api/revisions/3dd37f6a72d1?raw)