Asynchronous Task

Overview

The Maesn API supports asynchronous operations for the following endpoints:

To track the status of these requests, the API provides the GET /asyncTask endpoint. When an asynchronous request is made, the response body includes a taskId, a unique identifier that allows clients to check the progress or result of the operation. This taskId is used as a parameter in GET /asyncTask, enabling efficient status tracking of background processes.

Example

Here is an example of a partial response from an asynchronous operation:

{
  "data": {
    "accountId": "CashLedger",
    "accountingPeriodId": "01-2025",
    "currency": "EUR",
    "expenseLines": [
      {
        "accountId": "4613",
        "description": "Business lunch",
        "documentNumber": "INV-123",
        "totalGrossAmount": 49,
      }
    ],
    "taskId": "06D2F7324A1A4825B6200BA647017539",
    "totalGrossAmount": 49,
  },
  "meta": {}
}

If the task does not support partial responses, the returned response may be as simple as:

{
  "data": {
    "taskId": "06D2F7324A1A4825B6200BA647017539"
  },
  "meta": {}
}

To check the status of the task, this is how you can use the taskId in the GET /asyncTask endpoint:

Example code snippet

    const response = await axios.get(
    "https://api.maesn.dev/accounting/asyncTask/06D2F7324A1A4825B6200BA647017539", {
        headers: {
            'X-API-KEY': apiKey,
            'X-ACCOUNT-KEY': accountKey
        }
    });

Data retention

Maesn keeps the data of an async task only until you can fetch the result. This covers the request, the status, the result and any uploaded files. Maesn deletes this data automatically 7 days after the last status change of the task. Fetch the result within this window. After that, GET /asyncTask can no longer return it.

Last modified on November 11, 2026

Get started

Guides

Integrations

Use cases

API reference

Knowledgebase

Asynchronous Task

Overview

Example

Data retention