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
KLAAR OM TE STARTEN?

Stop met brandjes blussen. Begin met vooruit kijken.

Een gesprek van 30 minuten met een van de oprichters. Geen sales-pitch: we bekijken jouw cijfers, jouw setup en jouw vragen.

Plan een gesprek
Vertrouwd door bedrijven in BE · NL · FR · binnenkort ES & PT