Retrieves one or more certificate requests based on specified filters.
- Endpoint:
/api/v1/certificates/requests - Method:
GET - Request:
GET /api/v1/certificates/requests
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
code_request |
Integer |
No | Request code to search for. |
status_request |
Integer |
No | Request status code. |
type_certificate |
Integer |
No | Certificate type. |
type_domain |
String |
No | Domain type. |
organization |
Integer |
No | Organization code. |
common_name |
String |
No | Certificate common name. |
san |
String |
No | Subject Alternative Names (comma-separated). |
tags |
String |
No | Identification tags (comma-separated). |
encryption |
String |
No | Encryption algorithm. |
encryption_key_size |
Integer |
No | Encryption key size. |
algorithm_certified |
String |
No | Signature algorithm. |
validity |
Integer |
No | Validity period in days. |
environments |
String |
No | Environments (comma-separated). |
systems |
String |
No | Systems (comma-separated). |
design |
String |
No | Project name. |
ip_external |
String |
No | External IP address. |
ip_hostname |
String |
No | IP or hostname. |
responsible |
Integer |
No | Responsible user 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/certificates/requests?organization=42&limit=10" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Response
{
"status": 200,
"message": "Requests retrieved successfully",
"error": false,
"total": 5,
"requests": [
{
"code_request": 123,
"status_request": "1 - Pending",
"type_certificate": 2,
"type_domain": "SING",
"organization": 42,
"common_name": "api.example.com",
"encryption": "RSA",
"encryption_key_size": 2048,
"certificate_algorithm": "SHA256",
"validity": 365,
"justification": "Needed for new API service",
"description": "Certificate for public API endpoints"
}
// Additional requests will be listed here
]
}