Quick Start

Get started with fiskaly’s fiscal compliance APIs in minutes. This guide walks you through the essential steps to make your first API call.

Choose Your Product

SIGN DE (Germany)

KassenSichV compliant signing

SIGN AT (Austria)

RKSV compliant signing

SIGN FR (France)

NF525 compliant signing

SIGN ES (Spain)

TicketBAI & Verifactu

SIGN IT (Italy)

Italian fiscal compliance

eReceipt

Digital receipts

Prerequisites

Before you begin, you’ll need:

• A fiskaly account (create one at dashboard.fiskaly.com)
• API credentials (API Key and Secret)
• Postman or any HTTP client

⚠️Store credentials securely

Your API secret is shown only once when created. Store it immediately in a secure location such as a password manager or environment variable. Never commit secrets to source control.

Step-by-Step Setup

1. Create your organization

   Register at the fiskaly Dashboard and follow the onboarding steps. Your organization starts in the test environment by default.

2. Generate API credentials

   Go to Settings > API Keys in the dashboard and create a new API key. Save both the api_key and api_secret securely.

3. Authenticate

   Use your credentials to obtain an access token:

   cURLJavaScript

   curl -X POST https://kassensichv-middleware.fiskaly.com/api/v2/auth \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "api_secret": "YOUR_API_SECRET"
     }'

   The response contains an access_token valid for a limited time. Include it as a Bearer token in all subsequent requests.

4. Make your first request

   Use the access token to call any fiskaly API endpoint:

   cURLJavaScript

   curl -X GET https://kassensichv-middleware.fiskaly.com/api/v2/tss \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

💡Pro tip

Use our Postman Collections to explore the API interactively without writing code.

Using Postman

We provide pre-configured Postman collections for all our APIs:

1. Download

   Download the collection and environment for your product (links in the API Reference)

2. Import

   Import both files into Postman
3. Configure

   Update the environment variables with your API credentials

4. Run

   Run the requests in order to see the full flow

What’s Next?

API Reference

Explore all endpoints and schemas

SIGN DE Guide

Complete setup walkthrough for Germany

Country Modules

Learn about country-specific requirements

Need Help?

Support

Contact our support team

Error Handling

Common errors and how to resolve them

Postman Tutorial

Interactive API exploration guide