Empresas

/v1/companies · as pessoas jurídicas vinculáveis a contatos e negociações.

As empresas (pessoas jurídicas) vinculáveis a contatos e negociações.

Método	Rota	Operação
GET	/v1/companies, /v1/companies/{id}	read
POST	/v1/companies	insert
PUT	/v1/companies/{id}	update

O payload inclui os contadores deal_count (negociações ativas) e lead_count (contatos vinculados).

Filtros

Parâmetro	Comportamento
name	exato (sem diferenciar maiúsculas); name__contains para parcial
cnpj	exato, com ou sem máscara
owner_id	inteiro ou lista separada por vírgula (usuário responsável)
segment	exato (sem diferenciar maiúsculas); segment__contains para parcial
created_at__gte/__lte/__gt/__lt	comparação ISO 8601

Ordenação: name, created_at (padrão -created_at).

curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/companies?segment__contains=concession&sort=name"
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/companies?cnpj=12.345.678/0001-90"
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/companies/87"

Payload

{
  "data": {
    "id": 87,
    "name": "Auto360 Veículos",
    "cnpj": "12.345.678/0001-90",
    "owner_id": 3,
    "segment": "Concessionária",
    "observations": "Cliente desde 2023, sempre fecha no fim do mês.",
    "follower_ids": [3, 12],
    "deal_count": 14,
    "lead_count": 32,
    "created_at": "2023-05-02T10:00:00.000Z",
    "updated_at": "2026-06-20T16:30:00.000Z"
  }
}

Escrita

Campo	Tipo	Observações
name	string	obrigatório no POST; não anulável
cnpj	string	obrigatório no POST; validado e único na conta; imutável no PUT (422)
owner_id	inteiro, anulável	deve ser um usuário da conta
segment, observations	string, anulável
follower_ids	inteiro[]	substitui o conjunto de seguidores; todos devem ser usuários da conta

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"Auto360 Veículos","cnpj":"12.345.678/0001-90","segment":"Concessionária","owner_id":3}' \
  "https://app-api.atendeserver.com.br/v1/companies"

curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"observations":"Fecha sempre no fim do mês.","follower_ids":[3,12]}' \
  "https://app-api.atendeserver.com.br/v1/companies/87"