Changelog

Lumeo uses date-based API versioning. The current version is 2026-07. Breaking changes are introduced only with a new version and announced here at least 30 days in advance.

2026-07-01 — 2026-07

Initial public release of the Lumeo developer API.

New endpoints

• POST /payments/initiate — record a payout intent
• POST /payments/confirm — trigger compliance check and settlement
• GET /payments/payouts/:id — fetch payment status
• GET /compliance/fira/:firaId — fetch an auto-generated FIRA
• GET /compliance/gst/summary — year-to-date GST position
• GET /compliance/itr4/prefill — ITR-4 (44ADA) prefill data
• GET /ledger/accounts/:id/balance — account balance (paise, integer)
• GET /ledger/accounts/:id/entries — paginated journal entries
• GET /ledger/reconciliation/:paymentId — reconciliation status
• POST /ledger/reconciliation/:paymentId/resolve — manual reconciliation resolution
• GET /tax/liability — estimated income tax liability
• GET /tax/sequestration — sequestration reserve balance
• POST /tax/sequestration/policy — configure sequestration rate
• GET /tax/exports/gst3b — GST-3B-ready JSON export
• GET /tax/exports/itr4 — ITR-4-ready JSON export
• POST /webhooks — register a webhook endpoint
• GET /webhooks/:id/deliveries — delivery log with retry history

Webhook events (initial set)

payout.initiated, payout.confirmed, payout.settled, payout.failed, payout.manual_review, fira.generated, reconciliation.completed, reconciliation.pending, tax.updated, yield.allocated

SDKs

• @lumeo/sdk v1.0.0 — TypeScript / Node.js

---

Upcoming

The following are planned for a future release. They are not stable and not yet available in sandbox:

• GET /payments/payouts — paginated list with date/status filtering
• POST /payments/payouts/:id/cancel — cancel a payment before settlement
• Batch payout endpoint — up to 50 recipients in a single call
• Python and Go SDKs
• Yield allocation API — configure and query yield instrument allocation