Skip to main content
POST
Create a TSE export

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-OpenFiskal-Merchant
string
required

Merchant identifier returned by the merchants resource.

Body

application/json
from
string<date-time>
required
Example:

"2026-03-01T00:00:00.000Z"

to
string<date-time>
required
Example:

"2026-03-31T23:59:59.000Z"

register_id
string
required

Register whose signing device to export. NOT the scope: the register resolves to the TSE(s) it signed on during the window, and the archive covers those devices in full. A Swissbit TSE is shared by every register at the same business premises and offers no filtered export, so the archive contains their log messages too. A window spanning a device change resolves to both devices.

Example:

"reg_01HABC"

Response

Export job enqueued

id
string
required
type
enum<string>
required
Available options:
dsfinvk,
tse
status
enum<string>
required
Available options:
pending,
completed,
failed
from
string<date-time>
required
to
string<date-time>
required
created_at
string<date-time>
required
register_id
string | null
download_url
string | null

Signed URL to download the export artifact. Present only when status is completed.

error
object | null

Failure information. Present only when status is failed.

coverage
object | null

What the artifact covers. TSE exports only, and only once completed. Absent for other export types and while the export is still pending.

completed_at
string<date-time> | null