---
title: "Retrieve a Root Cause Analysis"
method: GET
path: "/v1/root-cause-analyses/{id}"
tags: ["Rocky AI"]
---

# Retrieve a Root Cause Analysis

`GET /v1/root-cause-analyses/{id}`

Retrieves a specific root cause analysis. Use the `id` returned from either POST endpoint and poll until the response is HTTP 200. While the analysis is being generated the endpoint returns HTTP 202 with `{"id":"<uuid>","status":"PENDING"}`. A genuine HTTP 404 means the ID does not exist. Works for both check error group and test session error group analyses.

## Path parameters

- `id` string, required

## Headers

- `x-checkly-account` string — Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- GetRca
  - `id` string, required
  - `checkType` string, required — Type of check that triggered this analysis, e.g. "API" or "BROWSER"
  - `provider` string, required — AI provider used for the analysis
  - `model` string, required — AI model used for the analysis
  - `checkId` string, nullable
  - `errorGroupId` string, nullable
  - `durationMs` number, required — Time taken to generate the analysis in milliseconds
  - `analysis` Analysis
    - `classification` string, required — High-level error categorization. e.g. "INFRA ERROR"
    - `userImpact` string, required — Human-readable summary of how this failure affects end users
    - `rootCause` string, required — Explanation of the underlying cause of the failure
    - `codeFix` string, nullable — Suggested code or configuration change to resolve the issue
    - `evidence` Model74[], nullable — Supporting evidence derived from check result artifacts
      - `artifacts` Model73[], required — Artifacts referenced by this piece of evidence
        - `name` string, required — Identifier of the artifact, e.g. "HTTP_REQUEST" or "TIMING_PHASES"
        - `type` string, required — Category of the artifact, e.g. "REQUEST", "TIMINGS", or "TRACE"
      - `description` string, required — Explanation of how this evidence support the root cause analysis
    - `referenceLinks` Model75[], nullable — Links to relevant documentation or external resources
      - `url` string, required — URL of the reference resource
      - `title` string, required — Display title for the link
  - `status` 'COMPLETED', required
  - `created_at` string, date

## Other responses

- `202` — Accepted
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/checklyhq/apis/checkly-public-api.md) · [All operations](https://skmtc.net/checklyhq/apis/checkly-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checklyhq/checkly-public-api/revisions/87d29dc7b4fe/schema)