---
title: "Panorama do tema: taxa de provimento por turma, relator e ano"
method: GET
path: "/api/v1/panorama"
tags: ["Jurimetria"]
---

# Panorama do tema: taxa de provimento por turma, relator e ano

`GET /api/v1/panorama`

## Request

- Base URL: `https://api.ragjur.ai`
- URL: `https://api.ragjur.ai/api/v1/panorama`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2 (authorization code, authorization URL `https://mcp.ragjur.ai/oauth/authorize`, token URL `https://mcp.ragjur.ai/oauth/token`, scopes: `ragjur:read`)

Classifica as decisões do tema em categorias de resultado (favorável/desfavorável/parcial…) e agrega por turma (top 10), relator (top 10) e ano. `merito=true` indica que a taxa considera só decisões de mérito classificadas.

## Query parameters

- `busca` string
- `fonte` string
- `tribunal` string
- `turma` string

## Response `200`

Panorama

- object
  - `fonte` string
  - `tribunal` string
  - `turma` string
  - `busca` string
  - `merito` boolean
  - `categorias` object[]
    - `key` string
    - `label` string
    - `cor` string
  - `labelFavoravel` string
  - `total` integer
  - `classificados` integer
  - `favoravel` integer
  - `desfavoravel` integer
  - `taxa_geral` number: % favorável (0–100)
  - `turmas` object[]
    - `turma` string: Órgão julgador
    - `total` integer
    - `classificados` integer
    - `favoravel` integer
    - `desfavoravel` integer
    - `taxa_favoravel` number: Percentual (0–100)
  - `relatores` object[]
    - `relator` string: Relator
    - `total` integer
    - `classificados` integer
    - `favoravel` integer
    - `desfavoravel` integer
    - `taxa_favoravel` number: Percentual (0–100)
  - `anos` object[]
    - `ano` string
    - `total` integer
    - `classificados` integer
    - `favoravel` integer
    - `desfavoravel` integer
    - `taxa` number
  - `_meta` object: Qualidade da amostra: n ≥ 100 alta, ≥ 30 média, ≥ 10 baixa, < 10 insuficiente.
    - `n` integer
    - `confianca` 'alta' | 'media' | 'baixa' | 'insuficiente'
    - `nota` string

## Other responses

- `401`: Sem `x-api-key` ou chave inválida
- `403`: Chave desativada
- `429`: Rate limit excedido (janela deslizante por chave). Ver `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`.
- `500`: Erro interno

---

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