Introduction

FiscalRail is a JSON API for creating and managing compliant invoices. Requests and responses use JSON, resource objects include an object field, and errors use a consistent JSON envelope.

Live and test environments

Every account has separate live and test environments. They use the same API and resource shapes, but have separate API keys and data.

Use the test environment while building your integration. Test invoices are clearly marked and do not consume account balance. Switch to a live secret key when you are ready to create real invoices.

The secret key used for a request selects the environment. You do not need to change the API URL. Every resource object includes live: it is true for live data and false for test data.

All endpoints are served below /v1/ and require HTTPS.