---
title: "Lista as empresas da conta"
method: GET
path: "/v1/companies"
tags: ["Empresas"]
---

# Lista as empresas da conta

`GET /v1/companies`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/companies`
- Auth: HTTP bearer

Empresas da conta. A chave de teste de emissão também lista, pra saber em nome de qual empresa emitir o teste.

## Response `200`

OK

- Empresa[]
  - `id` string
  - `cnpj` string
  - `ambiente` 'SANDBOX' | 'PRODUCAO'
  - `ambienteAdn` 'HOMOLOGACAO' | 'PRODUCAO': Qual Ambiente de Dados Nacional (da Receita Federal) é consultado. HOMOLOGACAO nunca gera cobrança.
  - `escopoMonitoramento` 'RECEBIDAS' | 'EMITIDAS' | 'AMBAS': O que conta como visível/cobrável para esta empresa — todas as notas são sempre consultadas e guardadas, isso só afeta exibição e franquia.
  - `nomeExibicao` string, nullable
  - `razaoSocial` string, nullable
  - `estado` 'DRAFT' | 'VALIDATING' | 'ANALISANDO_HISTORICO' | 'INITIAL_SYNC' | 'ACTIVE' | 'PAUSED_BY_USER' | 'PAUSED_CERTIFICATE' | 'PAUSED_BILLING' | 'ERROR' | 'REMOVAL_PENDING' | 'REMOVED'
  - `nsuInicial` string
  - `nsuUltimoConfirmado` string, nullable
  - `ultimaConsultaEm` string, date-time, nullable
  - `monitorarDesde` string, date-time, nullable: Só notas emitidas a partir desta data aparecem e são cobradas. Ausência (null) = sem corte, todo o histórico aparece.
  - `certificadoValidoAte` string, date-time, nullable
  - `criadaEm` string, date-time
  - `atualizadaEm` string, date-time

## Other responses

- `401`: Chave de API ausente, inválida ou revogada.
- `429`: 120 requisições por minuto por chave excedidas (janela fixa de 60 s, alinhada ao relógio). Sem cabeçalho `Retry-After`: espere a virada do minuto. Nas rotas de conta, empresas e documentos o corpo é este; nas de emissão, lote, webhooks e eventos é problem+json `limite_de_requisicoes`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)