> ## Documentation Index > Fetch the complete documentation index at: https://docs.meshqu.com/llms.txt > Use this file to discover all available pages before exploring further. # List decisions for a policy > Cursor-paginated decision log for a single policy. Supports rule / type / date / version filters. If ?version is omitted, defaults to the active version — matching the "this version" default in the console Evidence tab. ## OpenAPI ````yaml /api/openapi.json get /v1/policies/{id}/decisions openapi: 3.1.0 info: title: MeshQu API description: >- Governance infrastructure for policy-aware AI decisions. MeshQu does not run tools. It governs decisions about them. version: 1.9.0 contact: name: MeshQu Support email: support@meshqu.com license: name: Proprietary servers: - url: https://api.meshqu.com description: Deployed environment security: - apiKey: [] tenantId: [] tags: - name: Operations description: Health, readiness, metrics, and signing keys - name: Policies description: Policy management - name: Policy Groups description: Policy group management - name: Decisions description: Policy evaluation and recording - name: Chains description: Decision chain verification and sealing - name: Receipts description: Public receipt and bundle retrieval - name: Forms description: Attestation forms and public submission - name: Alerts description: Alert management and webhooks - name: Audit description: Audit log retrieval and verification - name: API Keys description: API key administration - name: Admin description: Tenant and platform administration - name: Dashboard description: Console dashboard data - name: Metrics description: Decision and overview metrics - name: Fields description: Field catalogue - name: Settings description: Tenant settings - name: Rule Creation Logs description: Rule authoring telemetry paths: /v1/policies/{id}/decisions: get: tags: - Policies - Decisions summary: List decisions for a policy description: >- Cursor-paginated decision log for a single policy. Supports rule / type / date / version filters. If ?version is omitted, defaults to the active version — matching the "this version" default in the console Evidence tab. operationId: getV1PoliciesByIdDecisions parameters: - schema: maxLength: 100 type: string in: query name: rule required: false description: Filter to decisions whose violations include this rule code - schema: anyOf: - type: string enum: - ALLOW - type: string enum: - DENY - type: string enum: - REVIEW - type: string enum: - ALERT in: query name: type required: false description: Decision outcome - schema: format: date-time type: string in: query name: from required: false description: Lower bound on recorded_at - schema: format: date-time type: string in: query name: to required: false description: Upper bound on recorded_at - schema: minimum: 1 type: integer in: query name: version required: false description: >- Filter to decisions recorded under this policy version (defaults to the active version when omitted — matches the "this version" UI default) - schema: maxLength: 500 type: string in: query name: cursor required: false description: >- Opaque cursor returned by the previous page. Omit for the first page. - schema: minimum: 1 maximum: 200 default: 50 type: integer in: query name: limit required: false description: Items per page (default 50, max 200) - schema: format: uuid type: string in: path name: id required: true responses: '200': description: Cursor-paginated decision log scoped to a policy content: application/json: schema: description: Cursor-paginated decision log scoped to a policy type: object properties: items: type: array items: description: A recorded decision with full context type: object properties: id: format: uuid type: string tenant_id: format: uuid type: string idempotency_key: type: string decision_type: type: string decision: description: Decision outcome anyOf: - type: string enum: - ALLOW - type: string enum: - DENY - type: string enum: - REVIEW - type: string enum: - ALERT context: description: Canonical DecisionContext for policy evaluation type: object properties: decision_type: minLength: 1 description: Type of decision being evaluated type: string fields: description: Domain-agnostic field values for evaluation type: object additionalProperties: {} evidence: description: Supporting evidence for the decision type: array items: type: object properties: kind: description: >- Type of evidence (document, graph_query, external_api) type: string ref: description: Reference identifier for the evidence type: string hash: description: Content hash for verification type: string data: description: Additional evidence metadata type: object additionalProperties: {} required: - kind metadata: additionalProperties: true type: object properties: actor_id: description: Actor making the request type: string correlation_id: description: Request correlation ID type: string ip_address: description: IP address of the requestor type: string user_agent: description: User agent string type: string timestamp: format: date-time description: Request timestamp type: string source_artifact: description: Cryptographic binding to a source document type: object properties: type: description: Type of source artifact anyOf: - type: string enum: - PDF - type: string enum: - DOCX - type: string enum: - JSON_PAYLOAD - type: string enum: - IMAGE - type: string enum: - STRING - type: string enum: - OTHER hash: pattern: ^[a-f0-9]{64}$ description: >- SHA-256 hash of the artifact (64 lowercase hex characters) type: string hash_algorithm: description: Hash algorithm used (currently only SHA-256) type: string enum: - SHA-256 reference_id: maxLength: 255 description: Client reference ID for the artifact type: string filename: maxLength: 255 description: Original filename of the artifact type: string byte_size: minimum: 0 description: Size of the artifact in bytes type: integer required: - type - hash - hash_algorithm required: - decision_type - fields result: description: Result of a policy evaluation type: object properties: decision: description: 'Final decision: ALLOW, DENY, REVIEW, or ALERT' anyOf: - type: string enum: - ALLOW - type: string enum: - DENY - type: string enum: - REVIEW - type: string enum: - ALERT violations: description: List of policy violations detected type: array items: type: object properties: rule_code: description: >- Unique code identifying the rule that was violated type: string severity: description: Severity of the violation anyOf: - type: string enum: - low - type: string enum: - medium - type: string enum: - high - type: string enum: - critical reason_code: description: >- Structured reason code for programmatic aggregation anyOf: - type: string enum: - FIELD_MISSING - type: string enum: - FIELD_FORBIDDEN - type: string enum: - FIELD_TOO_SHORT - type: string enum: - DATE_INVALID - type: string enum: - DATE_EXPIRED - type: string enum: - DATE_IN_FUTURE - type: string enum: - DATE_TOO_LATE - type: string enum: - DATE_TOO_EARLY - type: string enum: - DATE_ORDER_VIOLATED - type: string enum: - VALUE_NOT_NUMERIC - type: string enum: - VALUE_BELOW_MIN - type: string enum: - VALUE_ABOVE_MAX - type: string enum: - VALUE_NOT_GREATER_THAN - type: string enum: - VALUE_NOT_LESS_THAN - type: string enum: - VALUE_NOT_ALLOWED - type: string enum: - VALUE_FORBIDDEN - type: string enum: - LIST_MISCONFIGURED reason: description: >- Human-readable explanation of the violation type: string field: description: Field that triggered the violation type: string actual_value: description: Actual value that caused the violation expected_value: description: Expected value or constraint details: description: Additional violation context type: object additionalProperties: {} policy_id: format: uuid description: Policy ID that owns the violated rule type: string is_shadow: description: >- Whether this violation came from a shadow-mode policy type: boolean required: - rule_code - severity - reason rules_evaluated: description: Number of rules evaluated type: integer rules_na: description: >- Number of rules skipped due to when clause not matching type: integer na_rules: description: >- Rules that were not applicable due to when clause type: array items: type: object properties: rule_code: description: Rule code that was skipped type: string when: description: The when clause that excluded the rule reason: description: >- Human-readable reason why the rule was not applicable type: string required: - rule_code - when - reason evaluation_time_ms: description: Evaluation duration in milliseconds type: number timestamp: format: date-time description: ISO timestamp of the evaluation type: string policy_snapshot_id: format: uuid description: UUID of the frozen policy snapshot used type: string evaluated_rules_hash: description: >- SHA-256 hash of the evaluated rules (code, condition, severity, when) type: string integrity_hash: description: SHA-256 integrity hash of the entire evaluation type: string signature: description: >- Base64url-encoded Ed25519 signature over the integrity hash type: string signature_kid: description: Key ID of the signing key used type: string signature_algorithm: description: Signature algorithm (ed25519) type: string transparency_anchor: description: >- Sigstore Rekor transparency anchor, null if anchoring failed anyOf: - type: object properties: provider: description: Transparency log provider type: string entry_uuid: description: Rekor entry UUID type: string log_index: description: Rekor log index type: integer inclusion_proof: type: object properties: hashes: type: array items: type: string log_index: type: integer root_hash: type: string tree_size: type: integer required: - hashes - log_index - root_hash - tree_size anchored_at: format: date-time description: When the entry was anchored type: string rekor_public_url: anyOf: - format: uri description: Direct URL to the Rekor entry type: string - type: 'null' required: - provider - entry_uuid - log_index - inclusion_proof - anchored_at - type: 'null' action: description: >- Action bound to the receipt (null when not bound) anyOf: - description: Action bound to this decision receipt type: object properties: type: description: >- Type of action authorized (e.g., payment_execute, loan_approve) type: string reference_id: description: >- Client's reference ID for the action (e.g., INV-88423) type: string metadata: description: Additional action metadata type: object additionalProperties: {} required: - type - reference_id - type: 'null' receipt_schema_version: description: >- Receipt envelope schema version (1 = legacy, 2 = RCP2) anyOf: - type: number enum: - 1 - type: number enum: - 2 policy_snapshot_digest: anyOf: - pattern: ^[0-9a-f]{64}$ description: >- SHA-256 hex digest of the canonical policy snapshot type: string - type: 'null' evidence_manifest_digest: anyOf: - pattern: ^[0-9a-f]{64}$ description: >- SHA-256 hex digest of the evidence manifest (if provided) type: string - type: 'null' shadow_converted: description: >- Whether shadow mode converted this decision (DENY suppressed to ALERT because every violation came from a shadow-mode policy). Bound into the integrity hash. type: boolean original_decision: description: >- Decision before shadow-mode conversion (null when no conversion occurred). Bound into the integrity hash. anyOf: - type: string enum: - ALLOW - type: string enum: - DENY - type: string enum: - REVIEW - type: string enum: - ALERT - type: 'null' required: - decision - violations - rules_evaluated - evaluation_time_ms - timestamp - policy_snapshot_id - evaluated_rules_hash - integrity_hash - transparency_anchor - action policy_snapshot_id: format: uuid type: string correlation_id: anyOf: - type: string - type: 'null' chain_id: description: >- Chain ID if this decision is part of a decision chain anyOf: - format: uuid type: string - type: 'null' chain_step: description: Step number within the chain (1-based) anyOf: - type: integer - type: 'null' parent_decision_id: description: Parent decision within the same chain anyOf: - format: uuid type: string - type: 'null' chain_integrity_hash: description: >- SHA-256 chain integrity hash (Phase 2 cryptographic chain proof) anyOf: - type: string - type: 'null' chain_signature: description: >- Chain proof signature. Post-DAH-205 records carry "chain-proof/v1:" + base64url(Ed25519 over the domain-separated chain-proof/v1 envelope); legacy records carry base64url(Ed25519 over the bare chain_integrity_hash). anyOf: - type: string - type: 'null' chain_signature_kid: description: Key ID that produced the chain signature anyOf: - type: string - type: 'null' chain_signature_algorithm: description: Signature algorithm (ed25519) anyOf: - type: string - type: 'null' recorded_at: format: date-time type: string created_at: format: date-time type: string policy: description: >- Policy metadata from the snapshot used for evaluation type: object properties: id: format: uuid description: Policy ID type: string code: description: Policy code (e.g., UCP600-14A) type: string name: description: Human-readable policy name type: string version: description: Policy version number type: integer required: - id - code - name - version governance_source: description: >- Attribution of which tenant policies governed this decision type: object properties: tenant_id: format: uuid description: Tenant ID whose policies governed this decision type: string tenant_name: description: >- Human-readable tenant name (snapshot at evaluation time) type: string level: minimum: 0 description: >- Governance level: 0 = local tenant, 1+ = inherited from parent type: integer required: - tenant_id - tenant_name - level policy_group_id: description: Policy group ID for filtering and audit anyOf: - format: uuid type: string - type: 'null' policy_group_code: description: Policy group code for filtering and audit anyOf: - type: string - type: 'null' evaluated_policies: description: >- Policies evaluated in this decision (populated for group evaluations) type: array items: description: A policy that was evaluated as part of a decision type: object properties: policy_id: format: uuid description: Policy ID type: string policy_code: description: Policy code type: string policy_name: description: Policy name type: string version: description: Policy version at time of evaluation type: integer policy_group_id: format: uuid description: Policy group ID type: string policy_group_code: description: Policy group code type: string shadow_mode: description: Whether policy was in shadow mode type: boolean rules: description: Rules that were evaluated within this policy type: array items: description: A rule within an evaluated policy type: object properties: code: description: Rule code type: string name: description: Rule name type: string when: description: >- When clause for conditional applicability required: - code - name regulatory_refs: description: Regulatory references this policy implements type: array items: type: string required: - policy_id - policy_code - policy_name - version - shadow_mode actor: description: Actor attribution — who or what made this decision type: object properties: id: minLength: 1 maxLength: 255 description: Stable identifier for the actor type: string type: description: Whether the actor is human or automated anyOf: - type: string enum: - human - type: string enum: - automated role: maxLength: 255 description: >- Caller-defined role label (e.g., MLRO, compliance_analyst) type: string authority: maxLength: 255 description: >- Freeform authority context (e.g., final_disposition) type: string display_name: maxLength: 255 description: Human-readable name for UI/reports type: string required: - id - type required: - id - tenant_id - idempotency_key - decision_type - decision - context - result - policy_snapshot_id - correlation_id - chain_id - chain_step - parent_decision_id - chain_integrity_hash - chain_signature - chain_signature_kid - chain_signature_algorithm - recorded_at - created_at - governance_source - policy_group_id - policy_group_code next_cursor: description: Opaque cursor for the next page, or null on the final page anyOf: - type: string - type: 'null' required: - items - next_cursor '400': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: description: Error code type: string message: description: Human-readable message type: string details: description: Additional error details required: - code - message correlation_id: description: Request correlation ID type: string required: - error '404': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: description: Error code type: string message: description: Human-readable message type: string details: description: Additional error details required: - code - message correlation_id: description: Request correlation ID type: string required: - error components: securitySchemes: apiKey: type: http scheme: bearer bearerFormat: mqu_ description: >- MeshQu API key passed as a bearer token: `Authorization: Bearer mqu_…`. Mint one in the console (Settings → API keys). tenantId: type: apiKey name: X-MeshQu-Tenant-Id in: header description: >- 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. ````