In development

We are working on a public invoice API.

CloudInvoice does not issue public API keys today. We are designing a workspace-scoped API for clients, GST-ready invoices, and verified payment events before opening access to external applications.

planned request shape
POST /v1/invoices
Authorization: Bearer workspace_key

{
  "client_id": "client_...",
  "currency": "INR",
  "tax_mode": "INTRA_STATE",
  "items": [...]
}

Planned scope

A small API around the billing workflow.

The first release will focus on records and events already supported by the web application rather than exposing every internal endpoint.

Clients and invoices

Create or reference clients, prepare invoice drafts, and read invoice state within one explicit workspace.

GST-aware line items

Represent quantities, prices, discounts, HSN or SAC codes, and intra-state or inter-state tax treatment.

Verified payment events

Receive an event after a supported gateway payment has been verified and recorded against an invoice.

Scoped credentials

Restrict every future credential to a workspace and a documented set of permissions.

Before access opens

The contract has to be safer than a copied internal route.

  1. 01

    Define stable resources

    Document client, invoice, line-item, payment, and error shapes.

  2. 02

    Scope every credential

    Bind keys to one workspace and explicit permissions.

  3. 03

    Add idempotency

    Make create and payment-event operations safe to retry.

  4. 04

    Publish versioned documentation

    Open access only after examples, limits, and change policy are available.

Current availability

No public keys, SDK, API SLA, or production endpoints are offered yet.

Access will be announced in the changelog.
Follow updates The web app remains the supported product.