---
title: "Ranking de empresas por métrica financeira"
method: GET
path: "/v1/ranking"
tags: ["Empresas"]
---

# Ranking de empresas por métrica financeira

`GET /v1/ranking`

## Request

- Base URL: `https://api.balancos.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.balancos.ai/v1/ranking`
- Auth: HTTP bearer

## Query parameters

- `metrica` string, required
- `uf` string
- `setor` string
- `limite` integer, nullable: Empresas por página, até 100; padrão 20.
- `inicio` integer: Posição do primeiro item da página, a partir de 1.

## Response `200`

Página do ranking: até 100 por chamada; `proximo_inicio` quando há mais.

- AppsApiModelosEnvelopeRanking
  - `dados` AppsApiModelosRanking, required
    - `metrica` string, required
    - `nota` string, required
    - `inicio` integer, required
    - `total` integer, nullable, required
    - `proximo_inicio` integer, nullable
    - `empresas` union, required
      - EmpresaRankingValor[]
        - `posicao` integer, required
        - `razao_social` string, required
        - `slug` string, required
        - `uf` string, nullable, required
        - `setor` string, nullable, required
        - `valor_em_reais` union, required
          - integer
          - number
        - `exercicio` integer, nullable, required
        - `link` string, required
      - EmpresaRankingCrescimento[]
        - `posicao` integer, required
        - `razao_social` string, required
        - `slug` string, required
        - `uf` string, nullable, required
        - `setor` string, nullable, required
        - `crescimento_ativo_total_pct` union, required
          - integer
          - number
        - `ativo_base` union, required
          - integer
          - number
        - `ativo_atual` union, required
          - integer
          - number
        - `de_ano` integer, required
        - `para_ano` integer, required
        - `link` string, required
    - `dica` string, nullable
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `parametro_invalido` ou `requisicao_invalida` (parâmetro desconhecido).
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `429`: `limite_excedido` (cota da conta) ou `limite_ip` (piso por IP).
- `503`: `indisponivel` — gold ou Supabase fora, ou falha ao concluir a medição.

---

[API](https://skmtc.dev/balancos/apis/balancos-ai-api-publica.md) · [All operations](https://skmtc.dev/balancos/apis/balancos-ai-api-publica/llms.txt) · [OpenAPI document](https://skmtc.dev/balancos/apis/balancos-ai-api-publica/revisions/389d7f383cb5?raw)