GET | List certificate publications

Retrieves certificate publications based on specified filters.

Endpoint: /api/certificate/publish/list
Method: GET
Request: GET /api/certificate/publish/list

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.
`plugin_type`	`string`	No	Filters publications by plugin type.
`profile_name`	`string`	No	Filters publications by the name of the publishing profile. Accepts partial matches.
`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" \
  -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]
    }
    // Additional publications will be listed here
  ]
}

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. This includes an invalid `plugin_type` filter value (error code `1076`) or an invalid `profile_name` filter value (error code `1077`).
401 Unauthorized	Unauthorized access.
403 Forbidden	Forbidden access.
404 Not Found	Resource not found.
500 Internal Server Error	Internal server error.