---
title: "Consultar un reporte"
method: GET
path: "/report_runs/{id}"
tags: ["reportRuns"]
---

# Consultar un reporte

`GET /report_runs/{id}`

Consulta el estado de un reporte. Cuando `status` es `succeeded`, `result.download_url` sirve el archivo.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Estado del reporte

- ReportRun — Un reporte pedido. Nace en `pending`; cuando `status` es `succeeded` aparece `result`, y si es `failed`, `error` dice por qué.
  - `id` string, required
  - `report_type` string, required
  - `status` 'pending' | 'succeeded' | 'failed', required
  - `parameters` ReportRunParameters, required
    - `interval_start` string, date
    - `interval_end` string, date
    - `currency` string
    - `format` 'csv' | 'xlsx'
  - `result` ReportRunResult — Vacío hasta que el archivo existe
    - `filename` string
    - `size_in_bytes` integer
    - `download_url` string
  - `error` string, nullable — Por qué falló el reporte, cuando falló
  - `created_at` string, date-time, required

## Other responses

- `404` — El reporte no existe o pertenece a otra cuenta

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/da12dce50f30/schema)