---
title: "get_financials"
method: POST
path: "/tools/get_financials"
tags: ["Tools"]
---

# get_financials

`POST /tools/get_financials`

## Request

- Base URL: `https://compabase.com/api/mcp`
- URL: `https://compabase.com/api/mcp/tools/get_financials`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Full financial statement metrics per fiscal period: cash, inventories, receivables,
liabilities, equity, cost breakdown, revenue lines, and other statement columns.

**Example prompts:** “Show cash, liabilities, and equity from 2019 to 2023.”
· “What was net profit and total assets year by year?”

## Request body

- object: Identify a company with at least one of name, krs, or nip.
  - `name` string: Company name when KRS/NIP is unknown (legal-form suffix optional).
  - `krs` string: KRS registry number (10 digits, zero-padded).
  - `nip` string: NIP tax number (10 digits, dashes optional).
  - `year_from` integer: Earliest fiscal year (e.g. 2019).
  - `year_to` integer: Latest fiscal year (e.g. 2023).

## Response `200`

Financial periods

- object

---

[API](https://skmtc.dev/compabase/apis/compabase-mcp.md) · [All operations](https://skmtc.dev/compabase/apis/compabase-mcp/llms.txt) · [OpenAPI document](https://skmtc.dev/compabase/apis/compabase-mcp/revisions/43169ccbb0f7?raw)
