---
title: "Visão geral da API"
description: "API REST do Emissor de Nota: emita NFS-e no padrão nacional, consulte guias do Simples e mantenha a carteira de empresas em dia direto do seu ERP."
url: https://docs.emissordenota.com/visao-geral
language: pt-BR
---
# API do Emissor de Nota

Emita NFS-e no padrão nacional, consulte guias do Simples e mantenha a carteira de empresas em dia direto do seu sistema contábil ou ERP. A API é REST, fala JSON e usa os mesmos dados que você vê no painel.

## Endereço base

Todas as chamadas usam HTTPS e começam por um destes endereços. O formato é o mesmo nos dois ambientes; só a chave e o endereço mudam.

| Ambiente | Endereço | Para quê |
| --- | --- | --- |
| Produção | https://api.emissordenota.com/v1 | Notas e guias com valor fiscal |
| Sandbox | https://sandbox.api.emissordenota.com/v1 | Testes. Nada é transmitido |

## Por onde começar

- [Início rápido](https://docs.emissordenota.com/inicio-rapido): Da chave de API à primeira NFS-e autorizada, em cinco passos no sandbox.
- [Autenticação](https://docs.emissordenota.com/autenticacao): Como gerar a chave, enviá-la nas chamadas e limitar o que ela pode fazer.
- [Webhooks](https://docs.emissordenota.com/webhooks): Receba o resultado da nota e os avisos de guia sem ficar consultando a API.

## O que dá para fazer

| Recurso | O que faz | Caminho |
| --- | --- | --- |
| Empresas | Lista e cadastra empresas da organização | /empresas |
| NFS-e | Emite, consulta, cancela e baixa o XML e o PDF das notas | /nfse |
| Clientes | Mantém os tomadores de cada empresa | /clientes |
| Serviços | Mantém os serviços com código de tributação nacional | /servicos |
| Guias | Consulta DAS e demais guias com valor, vencimento e PDF | /guias |
| Certificados | Informa a validade do certificado A1 de cada empresa | /certificados |
| Webhooks | Cadastra os endereços que recebem os eventos | /webhooks |

## Uma chamada de exemplo

Liste as empresas que a sua chave acessa. Se a resposta for 200, a autenticação está funcionando.

**cURL**

```bash
curl https://api.emissordenota.com/v1/empresas \
  -H "Authorization: Bearer edn_live_SUA_CHAVE"
```

**200 OK**

```json
{
  "dados": [
    {
      "id": "emp_8Kq2mXv41c",
      "razao_social": "Padaria Santa Clara Ltda",
      "cnpj": "12345678000190",
      "regime": "simples_nacional",
      "certificado_valido_ate": "2027-03-14"
    }
  ],
  "proximo_cursor": null
}
```

## Convenções

- Datas e horas em ISO 8601, no horário de Brasília (UTC−3).
- Valores em reais com ponto decimal, sem separador de milhar: 1500.00.
- CNPJ, CPF e CEP só com dígitos, sem pontos nem traços.
- Listas paginadas por cursor, com 50 itens por página.

> **Precisa de acesso?**
>
> Em um plano com acesso à API, o proprietário ou um administrador autorizado gera chaves em Configurações › API e integrações.
