Skip to main content

Invoices massive download

note

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_date is the date the first job downloads invoices from: set it in the past to download the archive too.
  • parameters.to_date is optional and ends the schedule at that date.
  • parameters.auto_renew is optional and defaults to true.
Pricing

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.