SmartDhandha API — v1

Your business data,
via any tool.

A clean REST API to read and write your SmartDhandha billing and HR data. Scope-controlled keys, moral rate limits, and interactive docs out of the box.

Get your API key Interactive Docs

Modules

14+

Endpoints

Scopes

API Assistant

Live

AI Powered

👋 Hi! I'm the SmartDhandha API assistant. Ask me anything about the API — endpoints, authentication, code examples, or rate limits.

All endpoints at a glance

Clean, predictable REST. Every response is { success, data } or { success: false, error }.

GET/api/v1/invoicesList invoices with filters — status, date, client, searchbilling:read

POST/api/v1/invoicesCreate a draft invoice with line items (totals auto-computed)billing:write

PATCH/api/v1/invoices/:idUpdate notes, dates, or advance status to sent / voidbilling:write

GET/api/v1/billsList vendor bills — filter by status, vendor, datebilling:read

POST/api/v1/leavesSubmit a leave request — earned or sick, startDate / endDateleaves:write

PATCH/api/v1/leaves/:idApprove or deny a pending leave — status: approved | deniedleaves:write

View all endpoints in Scalar docs

In production in 5 minutes

1. Create an API key in Settings → Developer. 2. Pick scopes. 3. Call the API.

Request

curl -X POST https://app.smartdhandha.com/api/v1/invoices \
  -H "Authorization: Bearer sd_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "party_abc123",
    "invoiceNumber": "INV-2025-001",
    "invoiceDate": "2025-04-01",
    "dueDate": "2025-04-30",
    "currency": "INR",
    "items": [
      {
        "description": "Consulting — April 2025",
        "quantity": 20,
        "unitPrice": 3500,
        "taxRate": 18
      }
    ]
  }'

Response201 Created

{
  "success": true,
  "data": {
    "id": "inv_9f3kd82",
    "invoiceNumber": "INV-2025-001",
    "status": "draft",
    "subTotal": "70000.00",
    "taxTotal": "12600.00",
    "totalAmount": "82600.00",
    "balanceDue": "82600.00",
    "currency": "INR",
    "invoiceDate": "2025-04-01",
    "dueDate": "2025-04-30"
  }
}

Built for real integrations

Not just an API — a secure integration layer designed for how founders actually work.

Scoped API Keys

Each key carries explicit scopes (billing:read, leaves:write…). A Zapier integration only sees what you allow — no over-provisioning.

Moral Credit Limit

A 30-day rolling credit window (default 1 000 req) prevents runaway automation. Clear 429 errors tell you exactly when the window resets.

Org Isolation

Every key is tied to one organization. A key can never read another org's data — enforced at the middleware level on every request.

Connect Any Tool

Works with Zapier, Make, n8n, or a raw curl command. Standard REST + JSON — no SDK required.

Keys Stored as Hashes

Raw keys are shown exactly once at creation and never saved. We store only the SHA-256 hash — even we can't recover your key.

Interactive Docs

Scalar-powered API reference with dark mode, live try-it, and auto-generated code samples in 20+ languages.

Start automating today.

Get started free Read the docs

Your business data,via any tool.