REST API · Developer Documentation

Integrate the infrastructure
in 5 minutes.

Complete REST API, interactive documentation, EU-sovereign hosting. We handle the regulatory complexity so you can focus on your product.

REST · JSON
OAuth 2.0
EU Hosted
Quickstart

Up and running in 3 steps.

From zero to your first receipt issued in production.

1
Get your credentials

A service account is provisioned by Limpidius when your access is set up. You receive a client_id and client_secret bound to your tenant and environment.

2
Authenticate

Exchange your credentials for a Bearer token via the OAuth 2.0 authorisation server. The token is valid for its indicated duration: cache it.

3
Issue your first receipt

Send a structured transaction to the Platon API. The API handles delivery, receipt formatting, and optional invoicing: in a single call.

cURL
 
# Obtain a Bearer token
curl --request POST \
  'https://accounts.limpidius.com/auth/realms/limpidius/protocol/openid-connect/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'client_id={YOUR_CLIENT_ID}' \
  --data-urlencode 'client_secret={YOUR_CLIENT_SECRET}'

# Use the token to call the API
curl --request POST \
  '{BASE_URL}/platon/transactions' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '{ ... }'
API Reference

Available endpoints.

REST API · OAuth 2.0 authentication · EU-sovereign hosting

POST
/platon/transactions
Issue a structured digital receipt from a POS transaction. Email or print delivery, itemised products, VAT data, and card payment details.
Read the documentation
Ecosystem

Other APIs & webhooks.

Platon is only one entry point among several. The rest of the infrastructure integrates via API too.

Socrate API

Print stream, transmit print commands intended for the thermal printer.

Learn more →
Nestor API

Receipt archiving and exposure, WebArchive, WebReceipt, PDF.

Learn more →
Homer API

Customer identification and GDPR consent portal.

Learn more →
Technical specifications

An API built for production.

Latency
<100ms
EU-West region
Uptime
99.9%
In production
Data
🇪🇺 EU
Sovereign hosting

The full documentation, ready to use.

Complete reference for endpoints, data schemas, authentication and webhooks.