---
title: "Lista construtoras cadastradas"
method: GET
path: "/builders"
tags: ["Construtoras"]
---

# Lista construtoras cadastradas

`GET /builders`

## Request

- Base URL: `https://obraaberta.com.br/api/v1`
- URL: `https://obraaberta.com.br/api/v1/builders`
- Auth: none declared

Lista construtoras cadastradas

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

OK

- ListaConstrutoras
  - `data` Construtora[]
    - `id` string
    - `slug` string
    - `name` string
    - `cnpj` string, nullable
    - `website` string, nullable
    - `phone` string, nullable
    - `founded_year` integer, nullable
    - `headquarters` string, nullable
    - `rating` object
      - `average` number, nullable
      - `count` integer
    - `reputation` Reputacao: ISE (Índice de Sinais de Estresse): parte de 100 e desconta obras atrasadas (peso 60) e paralisadas (peso 40) sobre o total.
      - `ise_score` integer
      - `completed_projects` integer
      - `active_projects` integer
      - `stalled_projects` integer
      - `delayed_projects` integer
      - `total_projects` integer
      - `legal_issues` integer, nullable
    - `stock_info` object, nullable
      - `ticker` string
    - `projects_count` integer
  - `pagination` Paginacao
    - `page` integer
    - `limit` integer
    - `total` integer
    - `pages` integer

## Other responses

- `400`: Parâmetro inválido
- `404`: Não encontrado
- `429`: Limite de requisições excedido
- `500`: Erro interno

---

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