---
title: "GET List certificates"
method: GET
path: "/api/certificates"
---

# GET List certificates

`GET /api/certificates`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/certificates`
- Auth: API key in header `Authorization`

Através deste endpoint você pode consultar os certificados digitais cadastrados para o usuário autenticado e identificar seu certificado padrão.

A resposta contém a lista de certificados no campo `data`. O campo `default_certificate` retorna os dados do certificado marcado como padrão ou `null` quando nenhum está definido.

Os certificados marcados como padrão aparecem primeiro na lista. Dentro de cada grupo, os registros são ordenados pelo ID decrescente. Não há paginação ou parâmetros de filtro.

Quando o usuário não possui certificados cadastrados, o endpoint retorna `data: []` e `default_certificate: null`.

**Observação:** esta consulta retorna os dados cadastrais dos certificados, sem verificar sua validade ou excluir certificados vencidos. O campo `cert_validade` é retornado como texto, sem formato fixo, e pode conter `Validade não informada`.

## Response `200`

Certificados do usuário

- object
  - `data` object[]: Lista de certificados digitais cadastrados para o usuário autenticado.
    - `id` integer: Identificador único do certificado.
    - `cert_nome` string: Nome do certificado. Se não estiver informado, é usado o nome cadastrado como credencial; se também estiver vazio, retorna Certificado sem nome.
    - `cert_emissor` string: Nome da autoridade certificadora que emitiu o certificado.
    - `cert_validade` string: Validade em texto livre (ex.: 12/08/2027 19:23) ou "Validade não informada".
    - `cert_modelo` string: Modelo do certificado (ex.: A1), ou null.
    - `is_default` integer: Indica se este é o certificado padrão: 1 para sim e 0 para não.
    - `source` string: Origem do certificado. Neste endpoint, o valor retornado é sempre own.
  - `default_certificate` object: Dados do certificado padrão do usuário ou null quando nenhum estiver definido.
    - `id` integer: Identificador único do certificado.
    - `cert_nome` string: Nome do certificado. Se não estiver informado, é usado o nome cadastrado como credencial; se também estiver vazio, retorna Certificado sem nome.
    - `cert_emissor` string: Nome da autoridade certificadora que emitiu o certificado.
    - `cert_validade` string: Validade informada para o certificado, retornada como texto. Se não estiver informada, retorna Validade não informada.
    - `cert_modelo` string: Modelo do certificado, quando informado.
    - `is_default` integer: Indica se este é o certificado padrão: 1 para sim e 0 para não.
    - `source` string: Origem do certificado. Neste endpoint, o valor retornado é sempre own.

## Changes

- **2026-11-03** `3db1513040ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/certificates/get.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)