---
title: "List Exports Endpoint"
method: GET
path: "/v2/exports"
tags: ["exports"]
---

# List Exports Endpoint

`GET /v2/exports`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/exports`
- Auth: HTTP bearer

List Exports

Retrieve a list of exports. By default, only shows exports created by the
current user. Admins can see all organization exports by setting include_all_org=true.

## Query parameters

- `limit` integer
- `include_all_org` boolean: If true (and user is admin), show all organization exports
- `user_id` string, nullable: Filter exports by the user who requested them (admin only)
- `created_after` string, date-time, nullable: Filter exports created on or after this date
- `created_before` string, date-time, nullable: Filter exports created on or before this date

## Response `200`

Successful Response

- ExportListResponse: Response containing a list of exports.
  - `exports` ExportResponse[], required
    - `id` string, required
    - `export_type` 'invoice' | 'partner' | 'payment' | 'analytics' | 'bank_transaction' | 'credit_memo' | 'customer_transaction' | 'invoice_pdf' | 'audit_log' | 'ask_stuut_table' | 'journal_entry' | 'ar_aging' | 'collections_readiness', required
    - `status` 'pending' | 'processing' | 'completed' | 'failed', required
    - `filters` object, nullable, required
    - `format` 'csv' | 'json', nullable, required
    - `error_code` 'limit_exceeded' | 'timed_out' | 'generation_failed', required
    - `record_count` integer, nullable, required: Number of rows included in the export. Journal exports in both CSV and JSON skip events without accounting snapshots and can complete with those events omitted. The response does not include a skipped-event count.
    - `download_url` string, nullable, required
    - `created_at` string, date-time, required
    - `started_at` string, date-time, required
    - `completed_at` string, date-time, required
    - `requested_by` ExportUserRef, required: Reference to the user who requested the export.
      - `id` string, required
      - `name` string, required
      - `email` string, required
    - `report_config_id` string, nullable, required: The report config this export was sent for, when it is a report send.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/3b5ab941f918?raw)