Skip to content

List renewal requests

GET
/v1/requests
curl --request GET \
--url 'https://api.nextpki.com/v1/requests?limit=50&offset=0' \
--header 'Authorization: Bearer <token>'

Lifecycle requests for the token’s tenant. Filter by state to find work waiting on approval (pending_approval) or renewals that failed.

limit
integer
default: 50 >= 1 <= 200
offset
integer
0
state
string
org_id
string format: uuid

Restrict to requests assigned to this organisation.

Liste

Media typeapplication/json
object
items
Array<object>
object
id
string format: uuid
previous_cert_id
string format: uuid
nullable
new_cert_id
string format: uuid
nullable
via_connector_id
string format: uuid
nullable
state
string
Allowed values: pending_approval approved csr_generated submitted issued deployed failed cancelled
state_reason
string
nullable
attempts
integer
org_id
string format: uuid
nullable
scheduled_at
string format: date-time
created_at
string format: date-time
updated_at
string format: date-time
limit
integer
offset
integer
Example
{
"items": [
{
"state": "pending_approval"
}
]
}

Missing, malformed, unknown or revoked token

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}

The token’s scopes do not cover this endpoint

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}