Documentation
Aozo Accounting API
GST invoicing, quotations, inventory, expenses and GST reporting — the full REST surface behind accounting.aozo.in.
Customers
| Method | Path | Description |
|---|
| GET | /customers | List customers |
| POST | /customers | Create a customer (gstin, outstandingBalance, …) |
| DELETE | /customers/:id | Delete a customer |
Items
| Method | Path | Description |
|---|
| GET | /items | List inventory items |
| POST | /items | Create an item (hsnCode, sku, price, stock, unit) |
| DELETE | /items/:id | Delete an item |
Expenses
| Method | Path | Description |
|---|
| GET | /expenses | List expenses |
| POST | /expenses | Log an expense (category, amount, paymentMode) |
| DELETE | /expenses/:id | Delete an expense |
Quotations
Estimates that convert straight into a GST invoice.
| Method | Path | Description |
|---|
| GET | /quotations | List quotations, with line items |
| POST | /quotations | Create a quotation — auto-numbered EST-YYYY-#### |
| POST | /quotations/:id/convert | Convert into an invoice, adding 18% GST |
curl -X POST https://accounting.aozo.in/api/quotations \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"orgId": "org_123",
"customerName": "Acme Retail",
"validUntil": "2026-08-15",
"items": [
{ "itemName": "Consulting hours", "quantity": 10, "unitPrice": 2500 }
]
}'
Invoices
Full GST invoicing — auto-computed tax, e-invoicing, pay links and payment reconciliation. Listing invoices is restricted to org ADMIN/OWNER.
| Method | Path | Description |
|---|
| GET | /invoices | List invoices — ADMIN/OWNER only |
| GET | /invoices/:id | Invoice details |
| POST | /invoices | Create an invoice — computes GST subtotal/tax, auto-numbers it |
| PUT | /invoices/:id | Update — recomputes totals, replaces line items |
| POST | /invoices/:id/einvoice | Generate a GST e-Invoice IRN, e-Way bill and UPI QR |
| POST | /invoices/:id/pay-link | Generate a UPI/checkout payment link |
| POST | /invoices/webhook/payment | Payment-gateway webhook — no auth header required |
| PUT | /invoices/:id/status | Update status only |
| DELETE | /invoices/:id | Delete an invoice |
🔓 The payment webhook skips normal auth on purpose
POST /api/invoices/webhook/payment is built for payment gateways, not your app — it reconciles by invoiceNumber and accepts a Razorpay-shaped payload directly.
curl -X POST https://accounting.aozo.in/api/invoices \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"orgId": "org_123",
"type": "invoice",
"customerName": "Acme Retail",
"customerGstin": "07AAACA1234B1Z5",
"dueDate": "2026-08-30",
"items": [
{ "itemName": "Office chairs", "hsnCode": "9401", "quantity": 4, "unitPrice": 5200, "gstRate": 18 }
]
}'
Reports
Admin-restricted, same as invoices.
| Method | Path | Description |
|---|
| GET | /reports | Sales, tax, expense and profit summary |
| GET | /reports/gstr1 | GSTR-1 export, ready for GST filing |
| GET | /reports/gstr3b | GSTR-3B summary metrics |
Organization
| Method | Path | Description |
|---|
| GET | /organization | List orgs you belong to |
| POST | /organization | Create an org |
| GET | /organization/:id | Org details |
| PUT | /organization/:id | Update — includes GSTIN, UPI ID, invoice template — ADMIN only |
| GET | /organization/:id/members | List members |
| POST | /organization/:id/members | Invite a member — ADMIN only, seat-limited |
| GET | /organization/:id/apikeys | List API keys — ADMIN only |
| POST | /organization/:id/apikeys | Generate an API key — ADMIN only |