---
title: "GET | Listar publicações de certificados"
slug: "api-clm-list-certificates-publications"
updated: 2026-09-02T17:03:44Z
published: 2026-09-02T17:03:44Z
canonical: "docs.senhasegura.io/api-clm-list-certificates-publications"
stale: true
---

> ## 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 publicações de certificados

Recupera publicações de certificados baseadas em filtros específicos.

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

## Parâmetros da requisição

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code_publication` | `int` | Não | Código da publicação. |
| `code_certified` | `int` | Não | Código do certificado. |
| `code_profile_publication` | `int` | Não | Código do perfil de publicação. |
| `plugin_type` | `string` | Não | Filtra publicações por tipo de *plugin*. |
| `profile_name` | `string` | Não | Filtra publicações pelo nome do perfil de publicação. Aceita correspondências parciais. |
| `creation_date` | `string` | Não | Data de registro da publicação. |
| `processed` | `int` | Não | *Status* de processamento da publicação. As opções são: 1 = Sim e 0 = Não. |
| `error` | `int` | Não | *Status* de erro da publicação. As opções são: 1 = Sim e 0 = Não. |
| `reason` | `int` | Não | Código de motivo para assinatura. Deve haver um código de motivo válido na Segura®. |
| `itsm_code` | `string` | Não | Código ITSM. Obrigatório se o campo **Código de governança obrigatório ao justificar** estiver habilitado no grupo de acesso do certificado. |
| `device` | `int` | Não | Código de publicação do dispositivo. |
| `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/publish/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

### Resposta

```
{
  "status": 200,
  "message": "Publications retrieved successfully",
  "error": false,
  "total": 2,
  "publications": [
    {
      "code_publishing": 567,
      "code_certified": 456,
      "code_profile_publication": 22,
      "creation_date": "2024-01-15",
      "processed": "1 - Yes",
      "error": "0 - No",
      "reason": "3 - Scheduled Renewal",
      "itsm_code": "CHG0012345",
      "plugin_type": "F5 Big-IP",
      "profile_name": "Production-F5-01",
      "devices": [101, 102, 103]
    }
    // Publicações adicionais serão exibidas aqui.
  ]
}
```

Info

Os campos `plugin_type` e `profile_name` retornam `null` quando não há um perfil de publicação associado à publicação.

### 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). Isso inclui um valor inválido para o filtro `plugin_type` (código de erro `1076`) ou para o filtro `profile_name` (código de erro `1077`). |
| **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. |