Developers

Ordalis API reference

Single endpoint. Bearer auth. Multipart upload. Typed JSON responses with confidence and page citations. Pull the spec into Postman, your IDE, or a Cursor / Claude MCP host — everything's published below.

Specifications

OpenAPI 3.1

Canonical machine-readable spec. Drop into Stoplight, Insomnia, or any OpenAPI tool.

Postman collection

Pre-built request examples for every endpoint. Auth scaffolded for bearer tokens.

Official Node and Python SDKs are on the roadmap. Until they ship, generate a client from the OpenAPI spec above with openapi-generator or hit the JSON endpoint directly — see the cURL quickstart below.

Quickstart (cURL)

curl https://api.ordalis.io/v1/convert \
  -H "Authorization: Bearer $ORDALIS_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@invoice.pdf" \
  -F "template_id=invoice"