# Introduction

### e-Invoicing Document Interchange API Specification

The Public REST API provides programmatic access to an e-invoicing platform operated by a certified service provider, enabling companies to securely send, receive, and manage electronic invoices and related business documents via automated document interchange.

This OpenAPI-based specification describes all available endpoints for integrating your ERP or other business applications with the service provider’s platform, including onboarding, invoice submission, status tracking, document retrieval, and reporting.

To use the API, you must obtain access credentials from your chosen service provider.

### Generating client libraries

You can generate strongly typed client libraries for various programming languages using the provided `openapi.yaml` file and the [OpenAPI Generator](https://openapi-generator.tech/).

1. Download the `sveracun-openapi.yaml` (or `sveracun-openapi.json`) file from this site.
2. Install the OpenAPI Generator following the instructions on the project website.
3. Run the generator for your preferred language. For example, to generate a Java client:



```bash
   openapi-generator-cli generate \
     -i sveracun-openapi.yaml \
     -g java \
     -o ./einvoice-java-client
```

Replace java with the desired generator (for example: typescript-axios, csharp, python) and adjust the output directory as needed.

#### Change log

Current version as of 01.03.2026.

- New methods:
  - `amsCheck` - checks if organization is registered in AMS by VAT number
  - `getPdf` - returns the PDF visualization generated by the platform
- Additional optional fields (`sortBy`,`filterBy`) in `/inbox/status`, `/outbox/status` requests - to allow sorting and filtering by given timestamps using different criteria (`issuedDateTime` by default).


Version as of 16.01.2026.

- Methods `getStatus` and `getInternalStatus` return a new field `internalStatusDetails` containing error messages with timestamp.


Version as of 31.12.2025.

- No breaking changes
- Major change - introduction of (optional) paging on endpoints returning lists of documents
- Additional document fields in `/inbox`, `/inbox/status`, `/outbox/status` and `getStatus`