Companies (global) — /api/v1/companies
Controller: CompaniesV1Controller
Auth: Bearer (JWT com tenantId tipicamente obrigatório para criação)
BD: conexão default (empresas / cronospay)
Tag: Empresas (global)
Rotas
| Método | Rota | Descrição |
|---|---|---|
POST | /api/v1/companies | Criar empresa |
GET | /api/v1/companies | Listar todas (paginado) |
POST /api/v1/companies
Criação global de empresa.
201 em sucesso · 409 se CNPJ em conflito (quando aplicável)
GET /api/v1/companies
Listagem global paginada (não filtra por tenant). Exige JWT com sub.
| Query | Default | Limite |
|---|---|---|
pageNumber | 1 | ≥ 1 |
pageSize | 20 | 1–100 |
Ver também o fluxo de cadastro completo: 16-cadastro-company.md e o diretório multi-tenant: 06-company-directory.md.