---
title: "Referência da API: todos os endpoints"
description: "Referência da API REST do Emissor de Nota: todos os endpoints de empresas, NFS-e, clientes, serviços, guias, certificados e webhooks em um só lugar."
url: https://docs.emissordenota.com/referencia
language: pt-BR
---
# Todos os endpoints

Os endpoints estão agrupados por recurso. Todos partem de https://api.emissordenota.com/v1, exigem uma chave de API e respondem em JSON.

## Empresas

As empresas da carteira do escritório. É o empresa_id daqui que identifica o emissor nas outras chamadas.

- [`GET /empresas`](https://docs.emissordenota.com/referencia/empresas): Lista as empresas da carteira
- [`POST /empresas`](https://docs.emissordenota.com/referencia/empresas): Cadastra uma empresa
- [`GET /empresas/{id}`](https://docs.emissordenota.com/referencia/empresas): Consulta uma empresa
- [`POST /empresas/{id}`](https://docs.emissordenota.com/referencia/empresas): Atualiza os dados cadastrais

## NFS-e

Emissão, consulta e cancelamento de notas de serviço no padrão nacional.

- [`POST /nfse`](https://docs.emissordenota.com/referencia/nfse): Emite uma nota
- [`GET /nfse`](https://docs.emissordenota.com/guias/baixar-xml-e-pdf#baixar-em-lote): Lista notas por empresa, período e status
- [`GET /nfse/{id}`](https://docs.emissordenota.com/guias/emitir-nfse#acompanhe-o-resultado): Consulta uma nota
- [`POST /nfse/{id}/cancelar`](https://docs.emissordenota.com/guias/cancelar-e-substituir#cancelar-uma-nota): Cancela uma nota autorizada
- [`POST /nfse/{id}/substituir`](https://docs.emissordenota.com/guias/cancelar-e-substituir#substituir-uma-nota): Emite uma nota que substitui a original
- [`GET /nfse/{id}/xml`](https://docs.emissordenota.com/guias/baixar-xml-e-pdf#baixar-os-arquivos-de-uma-nota): Baixa o XML autorizado
- [`GET /nfse/{id}/pdf`](https://docs.emissordenota.com/guias/baixar-xml-e-pdf#baixar-os-arquivos-de-uma-nota): Baixa o PDF da nota

## Clientes

Os tomadores de serviço de cada empresa, para reaproveitar na emissão.

- [`GET /clientes`](https://docs.emissordenota.com/referencia/clientes): Lista os clientes de uma empresa
- [`POST /clientes`](https://docs.emissordenota.com/referencia/clientes): Cadastra um cliente
- [`GET /clientes/{id}`](https://docs.emissordenota.com/referencia/clientes): Consulta um cliente
- [`POST /clientes/{id}`](https://docs.emissordenota.com/referencia/clientes): Atualiza um cliente
- [`DELETE /clientes/{id}`](https://docs.emissordenota.com/referencia/clientes): Remove um cliente

## Serviços

Os serviços que cada empresa presta, com código de tributação e descrição padrão.

- [`GET /servicos`](https://docs.emissordenota.com/referencia/servicos): Lista os serviços de uma empresa
- [`POST /servicos`](https://docs.emissordenota.com/referencia/servicos): Cadastra um serviço
- [`POST /servicos/{id}`](https://docs.emissordenota.com/referencia/servicos): Atualiza um serviço
- [`DELETE /servicos/{id}`](https://docs.emissordenota.com/referencia/servicos): Remove um serviço

## Guias

O DAS e as demais guias geradas para as empresas do Simples. Somente leitura.

- [`GET /guias`](https://docs.emissordenota.com/referencia/guias): Lista guias por empresa, competência e situação
- [`GET /guias/{id}`](https://docs.emissordenota.com/referencia/guias): Consulta uma guia
- [`GET /guias/{id}/pdf`](https://docs.emissordenota.com/referencia/guias): Baixa o PDF para pagamento

## Certificados

A validade do certificado A1 de cada empresa. O envio do arquivo é feito pelo painel.

- [`GET /certificados`](https://docs.emissordenota.com/referencia/certificados): Lista os certificados e suas validades
- [`GET /certificados/{empresa_id}`](https://docs.emissordenota.com/referencia/certificados): Consulta o certificado de uma empresa

## Endpoints de webhook

Os endereços do seu sistema que recebem os eventos.

- [`GET /webhooks`](https://docs.emissordenota.com/referencia/webhooks): Lista os endpoints cadastrados
- [`POST /webhooks`](https://docs.emissordenota.com/referencia/webhooks): Cadastra um endpoint
- [`POST /webhooks/{id}/testar`](https://docs.emissordenota.com/referencia/webhooks): Envia um evento de teste
- [`DELETE /webhooks/{id}`](https://docs.emissordenota.com/referencia/webhooks): Remove um endpoint
