---
title: "GET | List a certificate publication"
slug: "api-clm-list-a-certificate-publication"
updated: 2026-09-02T17:05:30Z
published: 2026-09-02T17:05:30Z
canonical: "docs.senhasegura.io/api-clm-list-a-certificate-publication"
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 | List a certificate publication

Retrieves one certificate publication based on specified filters.

- **Endpoint**: `/api/certificate/publish/list/{{publication_id}}`
- **Method**: `GET`
- **Request**: `GET /api/certificate/publish/list/{{publication_id}}`

## Request parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `code_publication` | `int` | No | Publication code. |
| `code_certified` | `int` | No | Certificate code. |
| `code_profile_publication` | `int` | No | Publication profile code. |
| `creation_date` | `string` | No | Publication registration date. |
| `processed` | `int` | No | Publication processing status. The options are: 1 = Yes and 0 = No. |
| `error` | `int` | No | Publication error status. The options are: 1 = Yes and 0 = No. |
| `reason` | `int` | No | Publication reason code. |
| `itsm_code` | `string` | No | ITSM code. Required if the **Governance code required when justifying** field is enabled in the certificate access group. |
| `device` | `int` | No | Publication device code. |
| `offset` | `int` | No | Pagination starting point. |
| `limit` | `int` | No | Number of records per page. |

### Example using cURL

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

### Response

```
{
  "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]
    }
  ]
}
```

Info

The `plugin_type` and `profile_name` fields return `null` when no publishing profile is associated with the publication.

### Error responses

| HTTP Status Code | Description |
| --- | --- |
| **400 Bad Request** | Invalid parameters provided. |
| **401 Unauthorized** | Unauthorized access. |
| **403 Forbidden** | Forbidden access. |
| **404 Not Found** | Resource not found. |
| **500 Internal Server Error** | Internal server error. |