Skip to content

Get Compliance Gaps

GET
/compliance/gaps

Identifies all compliance gaps in the current Space — Resource-Action pairs where the Resource has no valid Certificate for a required Action. Each gap includes the affected resource, action, and the units where the gap applies. Gaps are derived at query time from the obligation model (Resource -> Unit <- Action + type matching).

X-Space-Id
required
string format: uuid

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

Array<object>
object
resource
required

Resource missing a certificate

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 the resource lacks 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
units
required

Units where this gap applies

Array<object>
object
id
required

Unit ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required

Unit name

string
Example
Production Department

Unauthorized — missing or invalid JWT

Forbidden — insufficient permissions