> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar Seção por Tipo

> Retorna uma seção específica de um relatório pelo seu tipo, sem precisar do sectionId.

<Endpoint
  method="GET"
  path="/report/{id}/section/{sectionType}"
  headers={[
{
  name: "Authorization",
  type: "string",
  required: true,
  description: "Token JWT no formato Bearer. Exemplo: `Bearer abc123`"
}
]}
  pathParameters={[
{
  name: "id",
  type: "string",
  required: true,
  description: "ID do relatório"
},
{
  name: "sectionType",
  type: "string",
  required: true,
  description: "Tipo da seção (ex.: SUMMARY, LAWSUITS, BUREAU, SCR)"
}
]}
/>

### Quando usar

Use este endpoint para buscar uma seção de um relatório usando o **tipo** (`sectionType`) em vez do `sectionId`. Útil em telas que renderizam abas por seção, carregam conteúdo sob demanda ou quando você só tem o ID do relatório e quer um bloco específico (ex.: score do bureau, processos judiciais).

### Autenticação

Bearer JWT no header `Authorization`.

### Parâmetros

| Nome          | Local  | Tipo     | Obrigatório | Descrição                                                                                                          |
| ------------- | ------ | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------ |
| `id`          | `path` | `string` | `sim`       | ID do relatório.                                                                                                   |
| `sectionType` | `path` | `string` | `sim`       | Tipo da seção. Valores comuns: `SUMMARY`, `LAWSUITS`, `BUREAU`, `SCR`, `PROTESTS`, `PEFIN_REFIN`, `PEP_SANCTIONS`. |

<RequestExample>
  ```bash cURL theme={null}
  curl --location 'https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/section/SUMMARY' \
  --header 'Authorization: Bearer abc123'
  ```

  ```javascript JavaScript theme={null}
  fetch("https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/section/SUMMARY", {
    method: "GET",
    headers: {
      "Authorization": "Bearer abc123",
    },
  })
    .then(res => res.json())
    .then(console.log)
  ```

  ```python Python theme={null}
  import requests

  url = "https://gyra-core.gyramais.com.br/report/69a207bcdd0197828df9155a/section/SUMMARY"
  headers = {
    "Authorization": "Bearer abc123"
  }
  response = requests.get(url, headers=headers)
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "69a207bcdd0197828df9156a",
    "type": {
      "id": "672b49a91acad6953b56b109",
      "value": "SUMMARY"
    },
    "createdAt": "2026-02-27T21:08:11.938Z",
    "updatedAt": "2026-02-27T21:09:39.250Z"
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "code": 401,
    "message": "Token de acesso inválido."
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "code": 404,
    "message": "Section not found"
  }
  ```
</ResponseExample>