Get Expiring Certificates

GET

/compliance/expiring

Returns all Certificates in the current Space that expire within the specified number of days. Each result includes the certificate details, the associated resource and action, and the common unit IDs (units where both the resource and action are assigned). Useful for proactive compliance monitoring and alerting.

Authorizations

• OAuth2

Parameters

Query Parameters

withinDays

required

number

Header Parameters

X-Space-Id

required

string format: uuid

UUID of the target Space (tenant boundary). Validated against user access.

Responses

200

Array<object>

object

certificate

required

Expiring certificate

object

id

required

Certificate ID

string format: uuid

Example

880e8400-e29b-41d4-a716-446655440000

name

required

Certificate name

string

Example

Fire safety certificate 2026

issuedAt

required

Issue date (ISO 8601)

string

Example

2026-01-15

expiresAt

required

Expiration date (ISO 8601)

string

Example

2031-01-15

resource

required

Resource this certificate belongs to

object

id

required

Resource ID

string format: uuid

Example

550e8400-e29b-41d4-a716-446655440000

name

required

Resource name

string

Example

John Smith

type

required

Resource type

string

Allowed values: person equipment environment substance

Example

person

action

required

Action this certificate proves compliance with

object

id

required

Action ID

string format: uuid

Example

660e8400-e29b-41d4-a716-446655440000

name

required

Action name

string

Example

Fire safety training

type

required

Action type

string

Allowed values: training health check ppe maintenance

Example

training

commonUnitIds

required

Unit IDs where both the resource and action are assigned

Array<string>

Example

[
  "770e8400-e29b-41d4-a716-446655440000"
]

401

Unauthorized — missing or invalid JWT

403

Forbidden — insufficient permissions