---
title: "List root cause analysis reports"
method: GET
path: "/rootcauseanalysisreports"
tags: ["Root Cause Analysis Reports"]
---

# List root cause analysis reports

`GET /rootcauseanalysisreports`

Endpoint used to list root cause analysis report resources

## Query parameters

- `cursor` string — Last pagination reference
- `limit` integer — max number of Root Cause Analysis Reports returned
- `assets` integer[] — To filter by multiple asset IDs: `assets=630&assets=634`
- `statuses` string[] — To filter by multiple statuses: `statuses=DRAFT&statuses=DONE`
- `creators` integer[] — To filter by multiple creator IDs: `creators=23494&creators=79808`
- `archived` boolean — When true, return only archived reports. Defaults to false.
- `createdAfter` string, date-time — Return reports whose `createdAt` is at or after this ISO 8601 date-time (UTC).
- `createdBefore` string, date-time — Return reports whose `createdAt` is at or before this ISO 8601 date-time (UTC).
- `expand` string[] — To expand multiple fields: `expand=main_asset&expand=main_asset_status`

## Headers

- `x-organization-id` integer

## Response `200`

Successfully fetched Root Cause Analysis Reports list

- object
  - `rootCauseAnalysisReports` object[], required
    - `id` integer, required — Global ID of the Root Cause Analysis report.
    - `organizationId` integer — ID of the organization that owns this resource
    - `status` 'DONE' | 'DRAFT', required — Status of the Root Cause Analysis report
    - `mainAssetId` integer, required — ID of the asset the Root Cause Analysis report is primarily about.
    - `mainAssetStatusId` integer, nullable, required — ID of the asset status that was active on the main asset when the report was created. Null when no status was captured or the status has since been deleted.
    - `createdAt` string, date-time, required — Creation date of the report.
    - `updatedAt` string, date-time, nullable, required — Last update date of the report. Null for reports that have not been edited.
    - `completedAt` string, date-time, nullable, required — Date the report was marked as completed (status transitioned to DONE).
    - `incidentStartedAt` string, date-time, nullable, required — Date and time the incident the report covers started.
    - `incidentEndedAt` string, date-time, nullable, required — Date and time the incident the report covers ended.
    - `incidentDuration` integer, nullable, required — Duration of the incident in seconds. Null when either incident date is missing.
    - `repairTime` integer, nullable, required — Repair time in seconds.
    - `notes` object, nullable, required — Optional free-text notes for the report.
      - `text` string, required — Plain-text representation of the notes.
    - `creatorId` integer, required — ID of the user that created the report.
    - `updaterId` integer, nullable, required — ID of the user that last updated the report. Null for reports that have not been edited.
    - `archivedAt` string, date-time, nullable, required — Date the report was archived. Null when the report is active.
    - `relatedAssetIds` integer[], required — IDs of additional assets linked to this report. Excludes the main asset (see `mainAssetId`).
    - `workOrderIds` integer[], required — IDs of work orders linked to this report.
    - `mainAsset` object, nullable — Asset linked to the element (expand with query parameter)
      - `id` integer, required — Global ID of the asset
      - `name` string, required
      - `description` string, nullable, required
      - `parentId` integer, nullable, required — ID of the parent asset
      - `criticalityId` integer, nullable, required — ID of the criticality of the asset
      - `locationId` integer, nullable, required — ID of the location where the asset is located
      - `serialNumber` string, nullable, required — Serial number of the asset
      - `createdAt` string, date-time, required — Date & time at which the asset was created
      - `updatedAt` string, date-time, required — Date & time at which the asset was last updated. This doesn't include comments
      - `creatorId` integer, nullable, required — ID of the asset creator
    - `mainAssetStatus` object, nullable — Asset status that was active on the main asset when the report was created. (expand with query parameter)
      - `id` number — Global ID of the asset status.
      - `customStatus` object, nullable — Custom status assigned to asset.
        - `id` number
        - `label` string, required
        - `createdAt` string, date-time — Date & time at which the asset custom status was created.
        - `updatedAt` string, date-time — Date & time at which the asset custom status was last updated.
        - `deletedAt` string, date-time, nullable — Date at which the asset custom status was deleted.
        - `downtimeType` 'PLANNED' | 'UNPLANNED', nullable — Downtime type on asset custom statuses will always return null. Use downtime type on asset status instead.
      - `customStatusId` number, nullable — Id of the custom status assigned to asset.
      - `status` 'IGNORE' | 'OFFLINE' | 'ONLINE' — Asset status value.
      - `downtimeType` 'PLANNED' | 'UNPLANNED', nullable
      - `startedAt` string, date-time — Asset status effective start date.
      - `endedAt` string, date-time, nullable — Asset status effective end date.
      - `description` string, nullable
      - `createdAt` string, date-time — Date & time at which the asset status was created.
      - `updatedAt` string, date-time — Date & time at which the asset status was last updated.
      - `deletedAt` string, date-time, nullable — Date & time at which the asset status was deleted.
    - `problems` object[] — Problems documented in this report. (expand with query parameter)
      - `id` integer, required — Global ID of the Root Cause Analysis problem.
      - `category` object, nullable, required
        - `id` integer, required — Global ID of the Root Cause Analysis category.
        - `label` string, required — Label of the category.
      - `stepOptions` object[], required — Step options selected for this problem.
        - `id` integer, required — Global ID of the Root Cause Analysis step option.
        - `label` string, required — Label of the step option.
        - `stepType` 'ACTION' | 'CAUSE' | 'FAILURE' | 'PROBLEM_TYPE', required — Step type of the Root Cause Analysis step option
      - `notes` object, nullable, required — Optional free-text notes for the problem.
        - `text` string, required — Plain-text representation of the notes.
  - `nextCursor` string, nullable, required — The cursor to retrieve the next page of Root Cause Analysis Reports.
  - `nextPageUrl` string, nullable, required — Path with query parameters that can be used to retrieve the next page of Root Cause Analysis Reports.

## Other responses

- `400` — Error with query
- `401` — Invalid token

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)