> ## Documentation Index
> Fetch the complete documentation index at: https://absentify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Exporte

> Starte mit der absentify API einen Excel-, Lohnabrechnungs- oder Urlaubssalden-Export und lade die Datei herunter, sobald sie bereit ist.

Ein Administrator startet einen Export mit `POST /exports`. Die Antwort ist `202 Accepted` mit einer `Location`-URL. Rufe diese URL wiederholt mit `GET /exports/{id}/file` auf, bis sie `200` und die Datei zurückgibt. Sende den API-Schlüssel bei jeder Anfrage. Er ist nicht Teil der `Location`-URL.

Nur ein Administrator kann einen Export starten oder herunterladen. Die REST API erfordert Plus. Ein Zeitraum ohne Abwesenheiten erzeugt eine Datei.

Der Auftrag erscheint außerdem unter **Kürzliche Exporte** auf [Einstellungen > Export](/docs/de/roles/hr_admins/settings/export#kürzliche-exporte), mit **über API** neben dem anfordernden Benutzer. Jeder Admin kann dort **Herunterladen** wählen, sobald die Datei **Bereit** ist.

## Formate

Sende `format` als einen dieser Werte. Sie entsprechen den Formaten unter Einstellungen > Export für einen **Bereich**.

| `format` | Datei |
| - | - |
| `EXCEL` | **Kontingente und Abwesenheiten (Excel)** |
| `PAYROLL_EXCEL` | **Abwesenheiten für die Lohnabrechnung (Excel)** |
| `PAYROLL_CSV` | **Abwesenheiten für die Lohnabrechnung (CSV)** |
| `LEAVE_BALANCE_EXCEL` | **Urlaubssalden (Excel)** |

## Einen Export starten

```bash theme={null}
curl -X POST "https://api.absentify.com/api/v1/exports" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"format":"EXCEL","start":"2026-01-01","end":"2026-01-31"}'
```

`start` ist der erste Tag. `end` ist der letzte eingeschlossene Tag. Es zählt nur das UTC-Datum. Der Zeitraum darf höchstens **1826 Tage (5 Jahre)** umfassen. Größere oder umgekehrte Zeiträume geben `400` zurück.

Optionales `department_id` begrenzt die Datei auf eine Abteilung. Lasse es weg für alle Abteilungen. Bei `PAYROLL_CSV` ist optionales `csv_separator` `comma` oder `semicolon`.

Sende den Schlüssel als `X-API-KEY` oder als `Authorization: Bearer <key>`. In einer Power Automate HTTP-Aktion setzt du Authentication auf Raw mit `Bearer <key>`, damit derselbe Header auch gesendet wird, wenn Power Automate der `Location` folgt.

Der JSON-Body eines `202` ist `{ "id": "...", "status": "processing" }`. Rufe die `Location`-URL wiederholt auf. Warte die Sekunden in `Retry-After` (15) zwischen den Anfragen. Wenn `POST /exports` `429` zurückgibt, siehe [API-Limits](./limits).

## Die Datei herunterladen

`GET /exports/{id}/file` verwendet dieselben Anmeldedaten.

| Status | Was du tun kannst |
| - | - |
| `202` | Der Export läuft. Warte die Sekunden in `Retry-After` und rufe dieselbe URL erneut auf. |
| `200` | Speichere die Datei. Sie bleibt 24 Stunden verfügbar. |
| `422` | Der Export ist fehlgeschlagen. Siehe `error` im JSON-Body. |
| `410` | Die Datei ist abgelaufen. Starte einen neuen Export. |
| `404` | Der Export ist unbekannt oder älter als 30 Tage. |
| `403` | Nur ein Administrator kann die Datei herunterladen. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.