---
title: "Start async export of Clearing data for a given Mandator and given Timestamp range"
method: POST
path: "/public/digitalservices/mandatorClearingExportDownload"
tags: ["Digital Services API"]
---

# Start async export of Clearing data for a given Mandator and given Timestamp range

`POST /public/digitalservices/mandatorClearingExportDownload`

## Request

- Base URL: `https://test.tecs.at/merchantservices`
- URL: `https://test.tecs.at/merchantservices/public/digitalservices/mandatorClearingExportDownload`
- Auth: HTTP bearer

Starts asynchronous processing of clearing data export. Returns immediately with a fileId for tracking.
Required role for operation: BO_MANDATOR_CLEARING_EXPORT<br>
Supports authentication with the following types of tokens:<br>
* <b>Bearer</b> &lt;token&gt;, which is a Bearer token authentication. The bearer token is a cryptic string, usually generated by the server in response to a login request.

## Request body

- MandatorClearingExportDownloadRequest: Request for async mandator clearing export download
  - `clearingDateFrom` string, date-time, required: Start date for clearing export (inclusive)
  - `clearingDateTo` string, date-time, required: End date for clearing export (inclusive)
  - `filenameTemplate` string: Optional filename template for the export file

## Response `200`

Successful operation - processing started

- MandatorClearingExportDownloadResponse: Response for async mandator clearing export download request
  - `responseCode` integer
  - `responseMessage` string
  - `status` string: Processing status of the export request
  - `fileId` string: Unique file identifier for tracking and downloading

## Other responses

- `400`: * Invalid request data. Bad request * System is busy processing another file
- `401`: Unauthorized - Authentication failed:<br>
- `403`: Forbidden - Missing role: BO_MANDATOR_CLEARING_EXPORT
- `500`: Internal server error

## Changes

- **2026-11-03** `6e0e5a5a2b2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluefin-com/apis/merchant-services/changes/public/digitalservices/mandatorClearingExportDownload/post.md)

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) - [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) - [OpenAPI document](https://skmtc.dev/bluefin-com/apis/merchant-services/revisions/6e0e5a5a2b2f?raw)