GET | List a certificate publication

# 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",
      "devices": [101, 102, 103]
    }
  ]
}

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.