Base URLs & Environments
All fiskaly products provide separate TEST and LIVE environments. API keys generated in one environment only work with that environment’s resources.
SIGN Products
Section titled “SIGN Products”| Product | Test Base URL | Live Base URL | API Path |
|---|---|---|---|
| SIGN DE | https://kassensichv-middleware.fiskaly.com/api/v2 | https://kassensichv.fiskaly.com/api/v2 | /api/v2 |
| SIGN AT | https://rksv.fiskaly.com/api/v1 | https://rksv.fiskaly.com/api/v1 | /api/v1 |
| SIGN ES | https://test.es.sign.fiskaly.com/api/v1 | https://live.es.sign.fiskaly.com/api/v1 | /api/v1 |
| SIGN IT | https://test.api.fiskaly.com | https://live.api.fiskaly.com | Versioned paths |
| SIGN FR | https://test.api.fiskaly.com | https://live.api.fiskaly.com | Versioned paths |
| SIGN PT | https://test.api.fiskaly.com | https://live.api.fiskaly.com | Versioned paths |
Other Products
Section titled “Other Products”| Product | Test Base URL | Live Base URL | API Path |
|---|---|---|---|
| DSFINVK DE | https://dsfinvk.fiskaly.com/api/v1 | https://dsfinvk.fiskaly.com/api/v1 | /api/v1 |
| RECEIPT | https://receipt.fiskaly.com/api/v1 | https://receipt.fiskaly.com/api/v1 | /api/v1 |
| E-INVOICE | https://test.api.fiskaly.com | https://live.api.fiskaly.com | Versioned paths |
| HUB | https://hub.fiskaly.com/api/v0 | https://hub.fiskaly.com/api/v0 | /api/v0 |
Required Headers
Section titled “Required Headers”All Products
Section titled “All Products”| Header | Value | Required |
|---|---|---|
Authorization | Bearer <access_token> | All authenticated requests |
Content-Type | application/json | All requests with a body |
Newer APIs (SIGN PT, SIGN IT, SIGN FR, E-INVOICE)
Section titled “Newer APIs (SIGN PT, SIGN IT, SIGN FR, E-INVOICE)”These APIs share a common platform and require additional headers:
| Header | Value | Required |
|---|---|---|
X-Api-Version | 2026-02-03 (current) | All requests |
X-Idempotency-Key | UUIDv4 | All POST and PATCH requests |
X-Scope-Identifier | Organization UUID | When scoping to a specific UNIT |
SIGN ES
Section titled “SIGN ES”| Header | Value | Required |
|---|---|---|
Content-Type | application/json | All requests |
SIGN ES wraps all request bodies in a content envelope:
{"content": {...}}. This applies to authentication and all API calls.
Environment Behavior
Section titled “Environment Behavior”Records created in the LIVE environment are legally binding. Transactions in SIGN DE are signed by the BSI-certified TSS. Records in SIGN IT, SIGN FR, and SIGN PT are transmitted to the respective tax authority. Always develop and test in TEST first.
| Behavior | TEST | LIVE |
|---|---|---|
| Tax authority submission | No | Yes |
| Certification validation | Simulated | Real |
| Data retention | Standard | Per legal requirements |
| Rate limits | Standard | Standard |
When you are ready to go live, generate new API keys in the LIVE environment via the HUB. See the Switch to LIVE guide for step-by-step instructions.
Service Status
Section titled “Service Status”Monitor all fiskaly service endpoints at status.fiskaly.com.