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

# Payroll export documents

> Read-only payroll export metadata, supported formats, covered periods, and available file downloads.

Payroll export documents are tenant-owned and read-only through the Public API.

## Supported formats

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
sap_hcm
personio_csv
hrworks_csv
diamant_software_diamant_4
universal_csv
universal_txt
datev_lodas
datev_lug
```

## Endpoints

<CardGroup cols={2}>
  <Card title="List export documents" icon="list" href="/api-reference/payroll-export-documents/list">
    Filter metadata by tenant, type, start month, and end month.
  </Card>

  <Card title="Get export document" icon="file-spreadsheet" href="/api-reference/payroll-export-documents/get">
    Read filename, media type, covered period, and timestamps.
  </Card>

  <Card title="Download export document" icon="download" href="/api-reference/payroll-export-documents/download">
    Download the available file by document ID.
  </Card>
</CardGroup>

## Availability rule

`fileName` is nullable. When it is `null`, no file was produced and the client should not call the download endpoint blindly.

## Contract boundary

The public contract does not define export generation, deletion, a universal generation schedule, a universal retention period, or one required polling interval.

<Card title="Payroll retrieval guide" icon="workflow" href="/guides/payroll-exports" horizontal>
  Implement metadata selection, availability checks, downloads, retries, and downstream import tracking.
</Card>