---
title: "Export history + monthly usage"
method: GET
path: "/api/v1/user/exports"
tags: ["User"]
---

# Export history + monthly usage

`GET /api/v1/user/exports`

## Query parameters

- `limit` integer

## Response `200`

Recent + usage_summary {used, max, remaining, pct, unlimited}

- UserExportListResponse
  - `recent` UserExportRecord[], required
    - `id` integer
    - `type` string, nullable
    - `format` string, nullable
    - `rows_count` integer
    - `created_at` string
  - `usage` ExportUsageResponse, required
    - `used` integer, required
    - `max` integer, required
    - `remaining` integer, required
    - `pct` integer, required
    - `unlimited` boolean, required

## Other responses

- `400` — Invalid request
- `401` — Authentication required (no active session)
- `422` — The query is lexically valid but outside a documented numeric or length bound, or uses an unsupported indexed combination.

## Changes

- **2026-07-26** `996f96a11758` — 6 info
  - api operation id `getUserExports` was added
  - added the new optional `query` request parameter `limit`
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `400`
  - …2 more

[Change history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/user/exports/get.md)

---

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