GET | List certificates publications

Prev Next

# GET | List certificates publications

Retrieves one or more certificate publications based on specified filters.

  • Endpoint: /api/v1/publications
  • Method: GET
  • Request: GET /api/v1/publications

Request parameters

Parameter Type Required Description
code_publication Integer No Publication code.
code_certified Integer No Certificate code.
code_profile_publication Integer No Publication profile code.
creation_date String No Publication registration date.
processed Integer No Publication processing status. Values: 1 = Yes, 0 = No.
error Integer No Publication error status. Values: 1 = Yes, 0 = No.
reason Integer No Publication reason code.
itsm_code String No ITSM code text.
device Integer No Publication device code.
offset Integer No Pagination starting point.
limit Integer No Number of records per page.

Example using cURL

curl -X GET "https://[segura_vault_url]/api/v1/publications?code_certified=456&limit=10" \
  -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]
    }
    // Additional publications will be listed here
  ]
}

Error responses

HTTP status Description
400 Bad Request Invalid parameters or missing required fields.
401 Unauthorized Invalid or expired authentication token.
403 Forbidden Insufficient permissions to access the resource.
404 Not Found The requested resource does not exist.
409 Conflict Resource already exists or is in an incompatible state.
500 Internal Server Error Unexpected server-side error.