Introduction

The OneFinOps API is a programmatic gateway to the Indian GSTN portal. You use it to register invoices for IRN (e-invoicing), generate and manage e-Way Bills, and onboard the GSP credentials those flows depend on — without writing GSP-vendor-specific code or touching NIC's portals directly.

It's the same product surface that powers our web app: every endpoint a customer dashboard talks to is exposed here under /v1/* for direct API access.

What you can do today

More endpoints — taxpayer lookups, GSTR returns, 2A/2B reconciliation — are on the roadmap and will land on the same /v1/* surface with the same auth and error envelope.

How it's different

• GSP-vendor agnostic. You speak the OneFinOps API; we manage the GSP relationship (Adaequare today, others later) and absorb their schema churn.
• Idempotent by default. Every state-changing call honours Idempotency-Key so retries are safe.
• Stable error contract. Error codes are versioned with the public surface; vendor-side error passthrough lives in a separate upstream block so your code never has to grow with NIC's nuances.
• NIC-isomorphic vocabulary. Field names mirror the IRP / EWB spec so anyone who's read the NIC schema can map directly — but with clean PascalCase instead of cryptic short names.

Two environments, identical surface

Sandbox routes to NIC's IRP and EWB sandboxes; production routes to live NIC. See Sandbox vs Production.

Get started

1. Quickstart — generate your first IRN with curl in five minutes.
2. Authentication — issue an OAuth client and request a token.
3. E-Invoice walkthrough — the full lifecycle, including async retries and cancellation.