Skip to main content
MRAs (Matters Requiring Attention) track examination findings and their remediation. They are created from archived examinations and linked to specific request items.

​
List MRAs

​
method
GET
/api/mras
Returns all MRAs for the organization, enriched with examination names.
​
status
string
Filter by status (comma-separated). Valid values: open, remediation_in_progress, closed.
​
data.mras
array
Array of MRA objects. Each includes:
  • id — Human-readable ID (e.g., MRA-2026-001)
  • title — Finding title
  • description — Finding description
  • category — Regulatory category
  • status — open, remediation_in_progress, or closed
  • issuedDate — When the finding was issued
  • examinationId — Parent examination
  • examinationName — Parent examination name

​
Create MRA

​
method
POST
/api/examinations/{examId}/mras
Creates a new MRA for an archived examination.
​
examId
string
required
Examination ID. Must be in archived status.
​
title
string
required
Finding title.
​
description
string
Detailed finding description.
​
category
string
required
Regulatory category (e.g., internal_controls, cdd_kyc).
​
issuedDate
string
ISO date when the finding was issued.
​
linkedRequestItemIds
array
required
Array of request item IDs from the examination that led to this finding. At least one required.
​
data.mra
object
The created MRA with auto-generated ID (e.g., MRA-2026-001).

​
Update MRA

​
method
PATCH
/api/mras/{mraId}
​
mraId
string
required
MRA ID (e.g., MRA-2026-001).
​
title
string
Updated title.
​
description
string
Updated description.
​
issuedDate
string
Updated issued date.
​
status
string
New status. Transitions are forward-only: open → remediation_in_progress → closed.
Status transitions are forward-only. You cannot move an MRA back to a previous status.

​
List remediation evidence

​
method
GET
/api/mras/{mraId}/evidence
​
data.evidence
array
Array of remediation evidence files with id, fileName, filePath, fileSize, mimeType, createdAt.

​
Upload remediation evidence

​
method
POST
/api/mras/{mraId}/evidence
Upload a file demonstrating remediation progress.
​
file
file
required
The evidence file. Max 50 MB. Allowed: PDF, DOCX, XLSX, CSV, PNG, JPG.
​
data.evidence
object
The created evidence record.

​
Delete remediation evidence

​
method
DELETE
/api/mras/{mraId}/evidence/{evidenceId}
Deletes a remediation evidence file and cleans up from storage.