REST API

Sections

Getting Started Accounting & Finance Human Resources Document Management Analytics & Management Platform Data residency

Platform

Core Dynamic Forms AI Chat Import / Export REST API MCP Server

REST API

REST API

AltiusOne exposes a complete REST API built on Django REST Framework, documented with OpenAPI (drf-spectacular).

Authentication

The API uses JWT (JSON Web Tokens) via SimpleJWT:

# Obtain a token
curl -X POST /api/token/ \
  -d '{"username": "user", "password": "pass"}'

# Use the token
curl -H "Authorization: Bearer <access_token>" \
  /api/v1/comptabilite/ecritures/

Main endpoints

Module Endpoint Operations
Accounting /api/v1/comptabilite/ CRUD entries, accounts
Invoicing /api/v1/facturation/ CRUD invoices, quotes
VAT /api/v1/tva/ VAT returns
Payroll /api/v1/salaires/ Pay slips, certificates
Documents /api/v1/documents/ Upload, search
Projects /api/v1/projets/ Projects, tasks
Graph /api/v1/graph-*/ Entities, relations

OpenAPI documentation

  • Swagger UI — /api/docs/
  • ReDoc — /api/redoc/
  • OpenAPI Schema — /api/schema/

OAuth2 / OIDC

AltiusOne is also an OAuth2/OIDC provider, enabling:

  • SSO with Nextcloud via user_oidc
  • Integration with third-party applications
  • Mobile authentication (React Native app)

Interactions

  • Mobile — The React Native app consumes the REST API
  • Nextcloud — SSO via the OIDC provider
  • MCP — The MCP server uses the internal API
  • Import/Export — Imports can be performed via the API
Import / Export
On this page