REST API Reference

Integrate custom CRM, billing systems, or external ERPs directly with the Bisnexus financial engine.

Robust Authentication

Secure JWT-based scoped authentication. B2B tenant isolation enforced at the gateway.

Vouchers & Ledgers API

Create, read, and reconcile journal entries, debit/credit notes, and bank receipts.

Real-time Webhooks

Listen for real-time compliance events like GST voucher signs or ledger changes.

Core Endpoints

Ensure you set the Authorization: Bearer <access_token> header for all requests except authentication.

POST

/api/auth/login

Authenticate client session and retrieve short-lived session token.

Requirements & Context

Content-Type: application/json
Inputs strictly schema-validated via Zod
Idempotent checks run on mutations

Request BodyJSON

{
  "email": "api@company.com",
  "password": "your-secure-api-key"
}

Response Payload200 OK

{
  "session": {
    "access_token": "eyJhbGciOi...",
    "token_type": "bearer",
    "expires_in": 3600
  }
}

GET

/api/companies

Retrieve a list of authorized companies/tenants scoped to your credentials.

Requirements & Context

Content-Type: application/json
Inputs strictly schema-validated via Zod
Idempotent checks run on mutations

Response Payload200 OK

[
  {
    "id": "co_88f0bc2e-1d3a",
    "name": "Acme Corp India Ltd",
    "gstin": "27AAPCA1234F1Z5",
    "currency": "INR",
    "created_at": "2026-01-15T08:00:00Z"
  }
]

POST

/api/accounting/vouchers

Submit a new voucher. Double-entry validation will run automatically (Debit = Credit sum).

Requirements & Context

Content-Type: application/json
Inputs strictly schema-validated via Zod
Idempotent checks run on mutations

Request BodyJSON

{
  "company_id": "co_88f0bc2e-1d3a",
  "voucher_type": "JOURNAL",
  "date": "2026-05-24",
  "narration": "API Automated Depreciation Run",
  "items": [
    {
      "ledger_id": "led_depr_exp_99",
      "amount": 250000,
      "type": "DEBIT"
    },
    {
      "ledger_id": "led_acc_depr_fixed_12",
      "amount": 250000,
      "type": "CREDIT"
    }
  ]
}

Response Payload200 OK

{
  "success": true,
  "voucher_id": "vch_77daef89-231d",
  "status": "DRAFT",
  "gst_compliant": true,
  "net_balance_offset": 0
}

Request Sandbox API Access

Need a sandbox workspace or developer OAuth keys? Reach out to support to set up a developer account.

Contact Developer Support