---
title: "Get a report"
method: GET
path: "/v1/reports/{request_uuid}"
tags: ["Reports"]
---

# Get a report

`GET /v1/reports/{request_uuid}`

Get a company's report given the `request_uuid`. The response will include the report request's status and, if complete, the report URL.

Reports containing PHI are inaccessible with `company_reports:read:tier_2_only` data scope

scope: `company_reports:read`

## Path parameters

- `request_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

OK

- Report
  - `request_uuid` string — A unique identifier of the report request
  - `status` string — Current status of the report, possible values are 'succeeded', 'pending', or 'failed'
  - `report_urls` string[] — The array of urls to access the report

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

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