We publish a dated minor release roughly once a month. Pin your integration by setting Geldstuck-Version: YYYY-MM-DD - see versioning.

2026-04-01 - Document review & multi-endpoint secrets

2026-04-01
Current release
New
  • Document review API (/v1/document-review) - multi-round review workflow with signed decisions.
  • Per-endpoint webhook secrets. Register an endpoint with its own whsec_ so rotations are isolated.
  • webhook.delivery.failed meta-event.
Changed
  • transaction.status.changes renamed to transaction.status.changed. The old name still fires for 6 months.
  • Pagination now uses cursor-based (starting_after, ending_before) instead of offset. Offset parameters still work but are deprecated.
Deprecated
  • GET /transactions/gettoken - use GET /transactions/:id and read token from the response.

2026-01-15 - Bulk tenant provisioning

2026-01-15
New
  • POST /v1/tenants/bulk for white-label partners.
  • Rate-limit headers (X-RateLimit-*) on every response.
  • Expanded deterministic KYC testing coverage in test mode.
Changed
  • Webhook retry schedule extended to 10 attempts over 24 hours.

2025-10-01 - Source-of-funds v2

2025-10-01
New
  • 10 supported SoF document types, up from 4.
  • Deep $set behavior on SoF updates - safely patch individual document groups.
  • source_of_funds.reviewed webhook.
Breaking (major bump was considered but skipped with a 6-month overlap)
  • sourceOfFunds.documents array replaced with named top-level keys (bankStatement, salary, …). Legacy shape accepted until 2026-04-01.

2025-07-01 - v1 stable

2025-07-01
New
  • /v1 API promoted out of beta.
  • Webhook signatures (Geldstuck-Signature).
  • API key rotation with 10-minute old-key grace period.

Subscribe to updates

Want to be emailed when the API version bumps or a deprecation clock starts? Subscribe in the dashboard.