List Certificates

GET

/certificates

Returns a paginated list of Certificates in the current Space. Supports filtering by resource, action, compliance status (valid/expiring/expired), and text search. The thresholdDays parameter controls the “expiring” window (default: 30 days). Each item includes resolved resource and action names.

Authorizations

• OAuth2

Parameters

Query Parameters

page

number

default: 1 >= 1

Example

1

Page number (1-based)

limit

number

default: 20 >= 1 <= 100

Example

20

Items per page (max 100)

sortDir

string

Allowed values: asc desc

Example

asc

Sort direction

search

string

Example

fire safety

Search by name (case-insensitive)

resourceId

string format: uuid

Example

550e8400-e29b-41d4-a716-446655440000

Filter by Resource ID

actionId

string format: uuid

Example

660e8400-e29b-41d4-a716-446655440000

Filter by Action ID

status

string

Allowed values: valid expiring expired

Example

valid

Filter by compliance status

sortBy

string

Allowed values: name issuedAt expiresAt resourceName actionName

Example

expiresAt

Sort field

thresholdDays

number

>= 1 <= 365

Example

30

Expiration threshold in days for the “expiring” status filter (1-365)

Header Parameters

X-Space-Id

required

string format: uuid

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

Responses

200

object

data

required

Array<object>

object

id

required

Certificate ID

string format: uuid

Example

550e8400-e29b-41d4-a716-446655440000

name

required

Certificate name

string

Example

Fire safety certificate 2026

resourceId

required

Resource ID

string format: uuid

Example

770e8400-e29b-41d4-a716-446655440000

resourceName

required

Resource name

string

Example

John Smith

actionId

required

Action ID

string format: uuid

Example

880e8400-e29b-41d4-a716-446655440000

actionName

required

Action name

string

Example

Fire safety training

issuedAt

required

Issue date (ISO 8601)

string

Example

2026-01-15

expiresAt

required

Expiration date (ISO 8601)

string

Example

2031-01-15

attachmentCount

required

Number of attachments

number

Example

2

meta

required

object

page

required

Current page number

number

Example

1

limit

required

Items per page

number

Example

20

total

required

Total number of items

number

Example

42

totalPages

required

Total number of pages

number

Example

3

401

Unauthorized — missing or invalid JWT

403

Forbidden — insufficient permissions