Invoices massive download
Only invoices in the KSeF V3 structure, FA(3), are downloaded: see KSeF on the Polish government site.
How to schedule invoices download
Create a schedule with POST /schedules:
POST /schedules
Content-Type: application/json
{
"legalEntity": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
"jobType": "invoice-download",
"cronExpression": "0 2 * * *",
"parameters": {
"from_date": "2025-10-01"
}
}
The API returns 201 Created if the download is scheduled. Only one schedule per job type and Legal Entity is allowed.
cronExpression(UTC) is optional and defaults to daily at 02:00.parameters.from_dateis the date the first job downloads invoices from: set it in the past to download the archive too.parameters.to_dateis optional and ends the schedule at that date.parameters.auto_renewis optional and defaults totrue.
The scheduled download of invoices is a paid service. Please contact our Sales Team for more information.
Retrieve, update or delete the schedule
Use GET, PUT and DELETE /schedules/{uuid}.
PUT replaces the whole schedule. For example, to disable the subscription auto-renew:
PUT /schedules/{uuid}
Content-Type: application/json
{
"legalEntity": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
"jobType": "invoice-download",
"cronExpression": "0 2 * * *",
"parameters": {
"from_date": "2025-10-01",
"auto_renew": false
}
}
How to create an invoice download request
If you don't want to schedule the download, create a single job for a given date range with POST /jobs/invoice-download:
POST /jobs/invoice-download
Content-Type: application/json
{
"legalEntity": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
"fromDate": "2026-02-01",
"toDate": "2026-02-28"
}
Both dates are inclusive, and toDate must be before today. The job runs immediately, unless you set scheduledAt.
Follow the jobs, including the ones created by a schedule, with GET /jobs
and GET /jobs/{uuid}.
A job status is ready, started, completed or error.
How to retrieve the downloaded invoices
The downloaded invoices are listed by GET /invoices?direction=outgoing,
and each one can be downloaded as JSON, XML or PDF through the Accept header.
In general, you can run on them any operation available for the invoices.