Developers · Ingest API

Push je data naar Cashplannr.

De Ingest API laat externe platformen, ERP-systemen en je eigen IT-stack cashflow-relevante data pushen naar Cashplannr, voor partijen die geen kant-en-klare connector hebben of hun eigen pipeline willen draaien.

Swagger UI Volledige reference OpenAPI YAML
v1.2 · stable OAuth2 client_credentials OpenAPI 3.1
curl · ingest/v1/transactions
# 1. Get OAuth2 token
curl -X POST https://app.cashplannr.com/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=$CLIENT_ID" \
  -d "client_secret=$CLIENT_SECRET"

# 2. Push a transaction
curl -X POST https://app.cashplannr.com/ingest/v1/transactions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "tnt_8842",
    "source": "my-erp-prod",
    "external_id": "INV-2026-001",
    "type": "actual",
    "amount": -18400,
    "currency": "EUR",
    "due_date": "2026-06-02"
  }'
Wat je kan pushen

Vier resources in v1.
Eén canonical write-pad.

transactions

Werkelijke en verwachte cashstromen: facturen, deals, betalingen, voorspellingen.

POST /ingest/v1/transactions batch
companies

Klanten en leveranciers met BTW-nummers, betalingstermijnen en relaties.

POST /ingest/v1/companies batch
balances

Banksaldo-snapshots per rekening en per dag, voor live cashpositie.

POST /ingest/v1/balances batch
gl_codes

Grootboekrekeningen, voor automatische categorisatie en reporting.

POST /ingest/v1/gl_codes batch

Scaffold + roadmap: tenants, categories, bank_accounts. CRM-pipeline (deals, quotes, subscriptions) wordt gepusht als transactions met een forecast-type.

Hoe het werkt

Storage-shape API, gebouwd voor pipelines.

OAuth2 client-credentials

Server-to-server authenticatie met scopes per resource. Geen long-lived API-tokens nodig.

Idempotent by default

Elke push gebruikt source + external_id. Veilig herhalen, geen dubbele records, zelfs bij retries.

Batch én single

Stuur één record of duizenden in één call. Server splitst, valideert en upsert per item.

Multi-tenant tenant-scoping

Eén OAuth-client kan meerdere tenants beheren. Per call valideren we dat je toegang hebt.

Klaar om te beginnen?

OAuth2-client aanvragen.

Tijdens de pilot-fase geven we OAuth2-credentials handmatig uit. Stuur ons je use-case en we voorzien een client_id + secret met de juiste scopes.

Credentials aanvragen Eerst de docs bekijken
PRÊT À VOUS LANCER ?

Arrêtez d' éteindre des feux. Commencez à regarder devant.

14 jours gratuits. Sans carte. Comptabilité d'abord : 15 minutes entre l'inscription et la première prévision.
Cashplannr détecte votre première anomalie dans les 48 heures.

14 jours gratuits Planifier un appel
Ils nous font confiance en BE · NL · FR · bientôt ES & PT