The fiskaly Unified API is a single integration architecture that covers multiple countries. Integrate it once. Each new country takes only a few small, country-specific compliance adjustments, not a rewrite of your integration.
Countries
Section titled “Countries”| Country | Product | Group |
|---|---|---|
| 🇦🇹 Austria | SIGN AT | SIGN |
| 🇫🇷 France | SIGN FR | SIGN |
| 🇮🇹 Italy | SIGN IT | SIGN |
| 🇵🇹 Portugal | SIGN PT | SIGN |
| 🇸🇪 Sweden | SIGN SE | SIGN |
| 🇧🇪 Belgium | E-INVOICE BE | E-INVOICE |
| 🇩🇪 Germany | E-INVOICE DE | E-INVOICE |
| 🇮🇹 Italy | E-INVOICE IT | E-INVOICE |
Country-specific documentation
Section titled “Country-specific documentation”The API specification adapts to your market selection. Use the country selector at the top of the spec pages to pick the markets you integrate — the documentation then shows exactly what applies to your selection:
- Text without a flag is the shared baseline that applies to all selected countries.
- Blocks marked with a country flag (for example 🇮🇹 or 🇫🇷) provide additional country-specific information — extra fields, deviating behaviour, or additional requirements for that market.
- The Download button exports an OpenAPI file tailored to your current selection.
The same country-specific guidance appears throughout the guides in this section — each country group in the sidebar covers its market’s specifics.
Base URLs
Section titled “Base URLs”| Environment | URL |
|---|---|
| Test | test.api.fiskaly.com |
| Live | live.api.fiskaly.com |
Required headers
Section titled “Required headers”| Header | Description |
|---|---|
X-Api-Version | API version date, e.g. 2026-06-01 |
X-Scope-Identifier | Organization ID |
X-Idempotency-Key | UUIDv4 — required on every POST and PATCH |
Authorization | Bearer <access_token> |
Versioning
Section titled “Versioning”The Unified API uses calendar-based versioning (YYYY-MM-DD). The latest version is 2026-06-01.
| Version | SIGN | E-INVOICE |
|---|---|---|
2026-06-01 | AT, FR, IT, PT, SE | BE, DE, IT |
2026-05-04 | FR, IT, PT | BE, DE |
2026-02-03 | FR, IT | BE, DE |
vs. Specialized APIs
Section titled “vs. Specialized APIs”| Unified API | Specialized APIs | |
|---|---|---|
| Countries | AT1, FR, IT, PT, SE, BE2, DE2, ES (coming soon) | DE, AT, ES |
| Base URL | Shared across countries | Product-specific |
| Resource IDs | Server-generated | Client-generated UUIDs |
| Org management | Built into the API | Separate Management API |
| Adding a country | Minor schema adjustments | New integration required |
1 available via both APIs · 2 e-invoice only
SIGN DE and SIGN ES are Specialized APIs. The Unified API integration is already in the works. E-invoicing for Germany is already part of the Unified API.