GET | List requests

List certificate requests based on specified filters.

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

Request parameters

Parameter	Type	Required	Description
`code_request`	`int`	No	Request code to search for.
`status_request`	`int`	No	Request status code.
`type_certificate`	`int`	No	Certificate type.
`type_domain`	`string`	No	Domain type.
`organization`	`int`	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`	`int`	No	Encryption key size.
`algorithm_certified`	`string`	No	Signature algorithm.
`validity`	`int`	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`	`int`	No	Responsible user 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/request/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "1001: OK",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "1001: OK",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "data": {
        "code_request": "1",
        "status_request": "7 - Signed",
        "type_certificate": "DV SSL - Domain SSL",
        "type_domain": "Single domain",
        "organization": "organization",
        "common_name": "api-test.com",
        "san": "api-test",
        "tags": "",
        "validity": "100",
        "encryption": "RSA",
        "encryption_key_size": "4096",
        "algorithm_certified": "sha256",
        "password_key": "api-password-key",
        "password_revocation": "api-password-revocation",
        "environments": "",
        "systems": "",
        "project": "",
        "ip_external": "",
        "ip_hostname": "",
        "justification": "API test",
        "self_signed": "true",
        "ca": "",
        "responsible": "31 - api-user",
        "description": "API test"
    }
  // Additional requests will be listed here
}

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.