Skip to main content
Developer Platform

Build on Cantarell OS

The complete API for fuel supply chain operations. Orders, payments, compliance, credit scoring, fleet management, and real-time webhooks — all in one platform.

Start in 3 minutes

1

Get your API key

Sign up and generate an API key from the developer dashboard. Sandbox keys are free.

sk_sandbox_a1b2c3d4e5f6...
2

Make your first request

Authenticate with your key and fetch your first resource.

curl -X GET https://api.cantarell-os.tech/api/v2/orders \
  -H "Authorization: Bearer sk_sandbox_..."
3

Listen for events

Register a webhook and receive real-time notifications when things happen.

curl -X POST https://api.cantarell-os.tech/api/v2/webhooks \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"url":"https://you.com/hook","events":["order.*"]}'

Everything you need to integrate

Key

API Keys & Scopes

Granular permission scopes. Rate limits by tier. Key rotation with zero-downtime grace periods.

Webhook

Webhooks

30+ event types across 8 domains. HMAC-SHA256 signatures. Exponential backoff retries. Delivery logs.

Box

Sandbox

Isolated test environments with mock data. Simulated SPEI responses. Webhook event simulator.

Activity

Usage Analytics

Real-time request counts, error rates, latency metrics. Per-key usage tracking and rate limit monitoring.

Enterprise Security

SHA-256 key hashing. Timestamp-based replay prevention. Automatic circuit breakers. Full audit trails.

Multi-Market

Full support for Mexico (SPEI, CRE, SAT) and US (ACH, FMCSA, EPA) market operations via a single API.

Official SDKs

Code2

Python

pip install cantarell-sdk
Terminal

Node.js

npm install @cantarell/sdk
Command

cURL

Works out of the box
Gem

Ruby

gem install cantarell
Cantarell OS - The Operating System for Fuel Markets