---
title: "Endpoint para consultar el estado de un reporte"
method: GET
path: "/reports/{requestId}"
tags: ["Reportes"]
---

# Endpoint para consultar el estado de un reporte

`GET /reports/{requestId}`

Retorna el estado actual de un reporte solicitado previamente. Si el reporte está completado, incluye URLs prefirmadas para descargar los archivos generados (válidas por 15 minutos). Si el reporte falló, incluye la descripción del error. Los reportes tienen una retención de 60 días; después de este periodo el estado será EXPIRED y los archivos ya no estarán disponibles. Para obtener los datos nuevamente, deberá generar un nuevo reporte.

## Path parameters

- `requestId` string, uuid, required

## Response `200`

Estado actual del reporte solicitado

- union
  - object
    - `requestId` string, uuid — Identificador único de la solicitud del reporte
    - `status` 'RUNNING' — Estado actual del reporte
    - `createdAt` string, date-time — Fecha y hora de creación de la solicitud
    - `expiresAt` string, date-time — Fecha y hora en que el reporte y sus archivos serán eliminados automáticamente (60 días después de la creación)
  - object
    - `requestId` string, uuid — Identificador único de la solicitud del reporte
    - `status` 'COMPLETED' — Estado actual del reporte
    - `completedAt` string, date-time — Fecha y hora de finalización del reporte
    - `expiresAt` string, date-time — Fecha y hora en que el reporte y sus archivos serán eliminados automáticamente (60 días después de la creación)
    - `urls` string[] — URLs prefirmadas para descargar los archivos del reporte. Expiran en 15 minutos
  - object
    - `requestId` string, uuid — Identificador único de la solicitud del reporte
    - `status` 'FAILED' — Estado actual del reporte
    - `error` string — Descripción del error ocurrido

## Other responses

- `400` — Objeto que representa una respuesta de error por validaciones
- `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/versions/5fcb0d90e251/schema)