---
title: "List Reports"
method: GET
path: "/reports"
tags: ["Reports"]
---

# List Reports

`GET /reports`

## Request

- Base URL: `https://api.enterprise.airtm.com/v2`
- URL: `https://api.enterprise.airtm.com/v2/reports`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/docs/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

List existing reports

## Query parameters

- `before` string
- `after` string
- `type` 'PDF' | 'CSV' | 'XLSX', required: Type of activity report
- `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': The current status of the report - `PENDING`: The report is pending generation. - `IN_PROGRESS`: The report is currently being generated. - `COMPLETED`: The report has been generated and is ready for download. - `FAILED`: The report generation failed.
- `perPage` integer

## Response `200`

Ok

- PaginatedReport: Represents a paginated collection of items.
  - `items` Report[], required: The items in the current page.
    - `updatedAt` string, date-time, required: Report end date
    - `createdAt` string, date-time, required: Report end date
    - `periodTo` string, date-time, required: Report end date
    - `periodFrom` string, date-time, required: Report start date
    - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: The current status of the report - `PENDING`: The report is pending generation. - `IN_PROGRESS`: The report is currently being generated. - `COMPLETED`: The report has been generated and is ready for download. - `FAILED`: The report generation failed.
    - `enterpriseUserId` string, uuid, required: Unique ID of the enterprise
    - `type` 'PDF' | 'CSV' | 'XLSX', required: Type of activity report
    - `id` string, uuid, required: Unique ID of the report
  - `startCursor` string: The cursor for the first item in the current page.
  - `endCursor` string: The cursor for the last item in the current page.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/revisions/c9ed13d4c5c0?raw)