Items, Taxes & Accounts

Item master, the GST tax catalogue, and read-only access to the Chart of Accounts.

Items

GET/itemsList itemsAIBooks.items.READ

GET/items/{item_id}Get one itemAIBooks.items.READ

POST/itemsCreate an itemAIBooks.items.CREATE

PUT/items/{item_id}Update an itemAIBooks.items.UPDATE

POST/items/{item_id}/archiveArchive (soft-delete)AIBooks.items.UPDATE

DELETE/items/{item_id}Hard delete (only if unused)AIBooks.items.DELETE

Resource shape

{
  "item_id":     "it_widget",
  "item_name":   "Widget",
  "sku":         "W-100",
  "item_type":   "GOODS",          // GOODS | SERVICE
  "description": null,
  "hsn_or_sac":  "8421",
  "unit":        "NOS",
  "rate":        100.0,             // selling price
  "purchase_rate": 70.0,
  "tax_id":      "tx_gst_18",
  "status":      "ACTIVE",
  "created_time": "...",
  "last_modified_time": "..."
}

Taxes

GET/taxesList GST taxesAIBooks.taxes.READ

GET/taxes/{tax_id}Get one taxAIBooks.taxes.READ

Read-only. Tax rows ship with the org and are managed via the Settings UI on the main app — no public write endpoint.

{
  "tax_id":    "tx_gst_18",
  "name":      "GST 18%",
  "shape":     "INTRA_STATE",       // INTRA_STATE | INTER_STATE | RCM | EXEMPT | NIL_RATED | NON_GST
  "cgst":      9.0,
  "sgst":      9.0,
  "igst":      18.0,
  "cess":      0.0
}

Accounts (Chart of Accounts)

GET/accountsList active accountsAIBooks.accounts.READ

GET/accounts/{account_id}Get one accountAIBooks.accounts.READ

Read-only. Accounts are created via the Settings UI on the main app (or the system seeds them at org creation).

{
  "account_id":  "acc_ar",
  "code":        "1040",
  "name":        "Accounts Receivable",
  "account_type":"ACCOUNTS_RECEIVABLE",
  "parent_id":   null,
  "description": null,
  "current_balance": 458920.0,
  "currency_code": "INR",
  "is_active":   true,
  "is_system":   true
}