# Empresa

Estas rotas devolvem os **dados cadastrais da empresa dona da credencial**: razão social, nome fantasia, CNPJ, inscrições, contato e endereço, e os locais que ela cadastrou. Servem para preencher cabeçalho de documentos e conferir o cadastro em outro sistema.

**Escopo exigido:** `company:read`. Sem ele, as rotas respondem [`scope_missing`](https://developers.festero.com.br/errors.md#scope_missing).

São dados da própria empresa, não de terceiros, e por isso têm rota e escopo próprios: `GET /v1/me` nunca traz CNPJ nem endereço. Não saem o responsável pela conta (nome, documento e e-mail), o plano nem a assinatura. Só a empresa da credencial: filiais e matriz não entram.

[Testar na referência interativa](https://developers.festero.com.br/referencia/)

## Dados da empresa

### `GET /v1/company`

Campos: `id` (o mesmo `workspaceId` de `/v1/me`), `tradeName`, `legalName`, `taxIdType` e `taxId` (CNPJ ou CPF, só dígitos), `stateRegistration`, `cityRegistration`, `phone`, `email`, `commercialEmail`, `website`, `instagram`, `facebook`, o endereço (`street`, `number`, `complement`, `neighborhood`, `postalCode`, `city`, `state`) e `updatedAt`. Traz `ETag`.

## Locais

### `GET /v1/company/addresses`

Lista os locais cadastrados (matriz, salão, depósito): `label`, `isDefault` e o endereço. Lista curta, devolvida inteira (`nextCursor` nulo), com o local padrão primeiro.