# 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. |