Empresas

Gerenciamento de empresas e organizações vinculadas aos contatos.

GET /api/companies Auth

Listar Empresas

Retorna a lista paginada de empresas do usuário autenticado.

Query Parameters

page integer

Número da página (padrão: 1)

limit integer

Itens por página (padrão: 20, máx: 100)

search string

Busca por nome ou email

Status Codes

200 Lista retornada com sucesso

401 Não autenticado

Response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439022",
      "name": "Tech Solutions Ltda",
      "cnpj": "12.345.678/0001-90",
      "website": "https://techsolutions.com.br",
      "industry": "Tecnologia",
      "size": "11-50",
      "notes": "Cliente desde 2024",
      "createdAt": "2026-02-20T08:00:00Z"
    }
  ],
  "total": 38,
  "page": 1,
  "limit": 20
}

POST /api/companies Auth

Criar Empresa

Cadastra uma nova empresa.

Request Body

name string obrigatório

Razão social ou nome fantasia

cnpj string opcional

CNPJ (formato livre, validado automaticamente)

website string opcional

URL do site

industry string opcional

Setor de atuação

size string opcional

Porte: 1-10, 11-50, 51-200, 201-1000, 1000+

notes string opcional

Observações

Status Codes

201 Criado com sucesso

400 Dados inválidos

401 Não autenticado

Request

{
  "name": "Tech Solutions Ltda",
  "cnpj": "12.345.678/0001-90",
  "website": "https://techsolutions.com.br",
  "industry": "Tecnologia",
  "size": "11-50"
}

Response

{
  "id": "507f1f77bcf86cd799439022",
  "name": "Tech Solutions Ltda",
  "cnpj": "12.345.678/0001-90",
  "website": "https://techsolutions.com.br",
  "industry": "Tecnologia",
  "size": "11-50",
  "createdAt": "2026-05-07T10:00:00Z"
}

GET /api/companies/:id Auth

Buscar Empresa por ID

Retorna os dados completos de uma empresa específica.

Status Codes

200 Registro encontrado

401 Não autenticado

403 Sem permissão (não é o proprietário)

404 Não encontrado

Response

{
  "id": "507f1f77bcf86cd799439022",
  "name": "Tech Solutions Ltda",
  "cnpj": "12.345.678/0001-90",
  "website": "https://techsolutions.com.br",
  "industry": "Tecnologia",
  "size": "11-50",
  "notes": "Cliente desde 2024",
  "createdAt": "2026-02-20T08:00:00Z",
  "updatedAt": "2026-04-15T11:00:00Z"
}

PUT /api/companies/:id Auth

Atualizar Empresa

Atualiza os dados de uma empresa existente. Envie apenas os campos que deseja modificar.

Request Body

name string opcional

Razão social

cnpj string opcional

CNPJ

website string opcional

URL do site

industry string opcional

Setor de atuação

size string opcional

Porte

notes string opcional

Observações

Status Codes

200 Atualizado com sucesso

400 Dados inválidos

401 Não autenticado

403 Sem permissão (não é o proprietário)

404 Não encontrado

Request

{
  "industry": "SaaS",
  "notes": "Renovação contrato Q3/2026"
}

Response

{
  "id": "507f1f77bcf86cd799439022",
  "name": "Tech Solutions Ltda",
  "industry": "SaaS",
  "notes": "Renovação contrato Q3/2026",
  "updatedAt": "2026-05-07T15:30:00Z"
}

DELETE /api/companies/:id Auth

Remover Empresa

Remove permanentemente uma empresa. Contatos vinculados não são excluídos.

Status Codes

200 Removido com sucesso

401 Não autenticado

403 Sem permissão (não é o proprietário)

404 Não encontrado

Response

{
  "message": "Empresa excluída com sucesso"
}