---
title: "Generar un reporte"
method: POST
path: "/report_runs"
tags: ["reportRuns"]
---

# Generar un reporte

`POST /report_runs`

Pide un reporte y recógelo cuando esté listo: la respuesta nace en `pending`, y cuando `status` llega a `succeeded` aparece `result.download_url`. Si falla, `status` queda en `failed` y `error` explica por qué, para que dejes de esperarlo.

El archivo es el mismo estado de cuenta que se descarga desde el Dashboard, así que cuadra con lo que ya concilia tu contador. Con una llave de organización y sin `X-ACCOUNT-ID`, un solo reporte cubre todas las cuentas y gana una columna `Cuenta`; nombrando una cuenta, cubre solo esa.

## Headers

- `X-SECRET-KEY` string, required

## Request body

- object
  - `report_type` 'ledger.itemized.1', required — Tipo de reporte. Va versionado para que las columnas puedan cambiar sin romper integraciones.
  - `parameters` ReportRunsPostRequestBodyContentApplicationJsonSchemaParameters, required
    - `interval_start` string, date, required
    - `interval_end` string, date, required
    - `currency` string — Moneda del balance. Por defecto, la de la cuenta.
    - `format` 'csv' | 'xlsx'

## Response `201`

Reporte encolado

- 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

- `422` — Parámetros incompletos o tipo de reporte desconocido

---

[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)