---
title: "Report status"
method: GET
path: "/api/v1/reports/{id}"
tags: ["API v1"]
---

# Report status

`GET /api/v1/reports/{id}`

## Request

- Base URL: `https://api.rivalize.ai`
- URL: `https://api.rivalize.ai/api/v1/reports/{id}`
- Auth: HTTP bearer

Get report status and data. Returns the report data when generation is complete. Poll this until `data.status` is `completed`, `no_competitors` or `no_rivals` (the run stopped before any research because none of its competitors could be counted as a rival; `message` names each one and why, and no credits were used); a report still in the human spot-check queue (PRD-305) reports as `processing`. Both are finished and carry `report_data`: `no_competitors` is a report that analysed no competitor (a profile of the product alone, which names no threat), and `competitors_analyzed` is how many competitors the report analysed.

## Path parameters

- `id` string, required

## Response `200`

Success. The resource is returned in the `data` envelope.

- object: Success. The resource is returned in the `data` envelope.
  - `data` object, required

## Other responses

- `404`: Error. Carries a stable `code`, a human `message`, the HTTP `status`, and the `request_id` (also on the x-request-id response header).

---

[API](https://skmtc.dev/rivalize/apis/rivalize-api.md) · [All operations](https://skmtc.dev/rivalize/apis/rivalize-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rivalize/apis/rivalize-api/revisions/1c705ba465eb?raw)