Skip to main content
GET
List decisions

Authorizations

Authorization
string
header
required

MeshQu API key passed as a bearer token: Authorization: Bearer mqu_…. Mint one in the console (Settings → API keys).

X-MeshQu-Tenant-Id
string
header
required

Tenant UUID for multi-tenant isolation. Required on all authenticated routes — validated before authentication (middleware/tenant.ts), so a missing or non-UUID header returns 400 (MISSING_TENANT_ID / INVALID_TENANT_ID) before the API key is checked.

Query Parameters

limit
integer
default:50

Max items per page

Required range: 1 <= x <= 100
offset
integer
default:0

Items to skip

Required range: x >= 0
decision_type
string

Filter by decision type

decision

Decision outcome

Available options:
ALLOW
from_date
string<date-time>

Filter decisions from this date

to_date
string<date-time>

Filter decisions up to this date

policy_id
string<uuid>

Filter by policy ID

policy_code
string

Filter by policy code

policy_group_id
string<uuid>

Filter by policy group ID

policy_group_code
string

Filter by policy group code

source_artifact_hash
string

Filter by source artifact SHA-256 hash

Pattern: ^[a-f0-9]{64}$
ref
string

Reference code (XXXX-XXXX) to search by decision UUID prefix

Pattern: ^[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}$
correlation_id
string

Filter by correlation ID

chain_id
string<uuid>

Filter by decision chain ID

Response

200 - application/json

Paginated list of decisions

Paginated list of decisions

items
object[]
required
total
integer
required

Total count matching filters

limit
integer
required
offset
integer
required