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

# get_company_rankings

`POST /tools/get_company_rankings`

## Request

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

Revenue rank positions within industry (PKD), region (voivodeship), and all of Poland.
Returns one row per scope: `pkd_full`, `pkd_division`, `pkd_section`, `region`, `country`.

**Example prompts:** “Where does this company rank by revenue in Poland and in its industry?”

## 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).
  - `scope_type` 'pkd_full' | 'pkd_division' | 'pkd_section' | 'region' | 'country': Optional. Filter to a single scope. Omit for all.

## Response `200`

Ranking rows

- 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)
