---
title: "GET | Listar certificados"
slug: "api-clm-list-certificates"
updated: 2026-03-04T12:05:18Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-clm-list-certificates"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GET | Listar certificados

Lista certificados baseados em filtros específicos.

- ***Endpoint***: `/api/certificate/list`
- **Método**: `GET`
- **Requisição**: `GET /api/certificate/list`

## Parâmetros da requisição

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code_certificate` | `int` | Não | Código do certificado. |
| `status_certificate` | `int` | Não | *Status* do certificado. As opções são: 1 = Válido, 2 = Revogado, 3 = Pendente de renovação, e 4 = Expirado. |
| `active` | `int` | Não | Estado do certificado. As opções são: 1 = Ativo e 0 = Inativo. |
| `start_validity` | `string` | Não | Data de início da validade. |
| `end_validity` | `string` | Não | Data de fim da validade. |
| `origin_certificate` | `string` | Não | Origem do certificado. As opções são: `SCAN` = *Scan* e descoberta, `REQU` = Requisição, e `IMPO` = Importado manualmente. |
| `type_certificate` | `int` | Não | Tipo de certificado. |
| `type_domain` | `string` | Não | Tipo de domínio. |
| `organization` | `int` | Não | Código de organização. |
| `common_name` | `string` | Não | Nome comum do certificado. |
| `san` | `string` | Não | Nomes alternativos do assunto (separados por vírgula). |
| `tags` | `string` | Não | Tags de identificação (separadas por vírgula). |
| `encryption` | `string` | Não | Algoritmo de criptografia. |
| `encryption_key_size` | `int` | Não | Tamanho da chave de criptografia. |
| `algorithm_certified` | `string` | Não | Algoritmo de assinatura. |
| `validity` | `int` | Não | Período de validade do certificado em dias. |
| `environments` | `string` | Não | Ambientes (separados por vírgula). |
| `systems` | `string` | Não | Sistemas (separados por vírgula). |
| `project` | `string` | Não | Nome do projeto. |
| `ip_external` | `string` | Não | Endereço IP externo. |
| `ip_hostname` | `string` | Não | IP ou *hostname*. |
| `self_signed` | `int` | Não | Indica se é auto assinado. As opções são: 1 = `true` e 0 = `false`. |
| `ca` | `int` | Não | O código da CA responsável por assinar a requisição. O código é necessário caso o parâmetro `self-signed` esteja definido como `false`. |
| `responsible` | `int` | Não | Código do usuário responsável. |
| `offset` | `int` | Não | Ponto de início da paginação. |
| `limit` | `int` | Não | Número de registros por página. |

### Exemplo utilizando cURL

```
curl -X GET "https://[segura_vault_url]/api/certificate/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

### Resposta

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "1001: OK",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "1001: OK",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "data": [
        {
            "certificate_code": "1",
            "ca": "teste-api",
            "common_name": "teste-api",
            "san": null,
            "organization": "teste-api",
            "start_validity": "2024-10-02 12:29:46",
            "end_validity": "2025-10-02 12:29:46",
            "validity": "6",
            "encryption": "RSA",
            "encryption_key_size": "2048",
            "status_certificate": "Valid",
            "active": "Yes",
            "tags": null,
            "origin_certificate": "IMPO",
            "environments": null,
            "systems": null,
            "project": null,
            "responsible": null,
            "description": null
        }
        // Additional certificates will be listed here
    ]
}
```

### Respostas de erro

| Código de status HTTP | Descrição |
| --- | --- |
| **400 Bad Request** | Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido). |
| **401 Unauthorized** | Acesso não autorizado. |
| **403 Forbidden** | Permissão negada. |
| **404 Not Found** | Recurso não encontrado. |
| **500 Internal Server Error** | Erro interno do servidor. |