---
title: "Referência: Certificados"
description: "Referência do recurso Certificados da API: situação e validade do certificado digital A1 de cada empresa, listagem por vencimento e consulta por empresa."
url: https://docs.emissordenota.com/referencia/certificados
language: pt-BR
---
# Certificados

A validade do certificado digital A1 de cada empresa. O envio do arquivo é feito pelo painel: pela API você só consulta.

**Escopos**: empresas:ler

**URL base**

```bash
# Produção
https://api.emissordenota.com/v1

# Sandbox
https://sandbox.api.emissordenota.com/v1
```

## Endpoints

- `GET /v1/certificados`: Lista os certificados e suas validades
- `GET /v1/certificados/{empresa_id}`: Consulta o certificado de uma empresa

## O objeto certificado

- `empresa_id` (string): A empresa dona do certificado.
- `situacao` (string): valido, vencendo, vencido ou ausente.
- `titular` (string): Razão social gravada no certificado.
- `cnpj` (string): CNPJ gravado no certificado, só com dígitos.
- `valido_ate` (string): Data e hora em que o certificado expira, em ISO 8601.
- `dias_restantes` (integer): Dias até o vencimento. Fica negativo depois que o certificado vence.

**O objeto certificado**

```json
{
  "empresa_id": "emp_8Kq2mXv41c",
  "situacao": "vencendo",
  "titular": "STUDIO AURORA DESIGN LTDA",
  "cnpj": "12345678000190",
  "valido_ate": "2026-12-04T23:59:59-03:00",
  "dias_restantes": 24
}
```

## Listar certificados

`GET /v1/certificados`

Devolve um certificado por empresa liberada para a chave, do vencimento mais próximo para o mais distante.

**Parâmetros de consulta**

- `situacao` (string, opcional): valido, vencendo, vencido ou ausente. Use vencendo para montar um alerta.
- `limite` (integer, opcional): Itens por página. O padrão e o máximo são 50.
- `cursor` (string, opcional): O proximo_cursor da página anterior.

**GET /v1/certificados**

```bash
curl -G https://api.emissordenota.com/v1/certificados \
  -H "Authorization: Bearer $EDN_KEY" \
  -d situacao=vencendo
```

**Resposta · 200 OK**

```json
{
  "dados": [
    {
      "empresa_id": "emp_8Kq2mXv41c",
      "situacao": "vencendo",
      "valido_ate": "2026-12-04T23:59:59-03:00",
      "dias_restantes": 24
    }
  ],
  "proximo_cursor": null
}
```

## Consultar o certificado de uma empresa

`GET /v1/certificados/{empresa_id}`

Devolve o certificado em uso. Quando a empresa nunca enviou um certificado, a situação é ausente e os demais campos vêm null. Sem certificado válido a empresa não emite, e o evento certificado.vencendo avisa antes de isso acontecer.

## Erros

| Status | Código | Quando |
| --- | --- | --- |
| 403 | empresa_nao_autorizada | A chave não acessa essa empresa. |
| 404 | empresa_nao_encontrada | O id não existe nesse ambiente. |
