API Reference · v1

Every Subcidys API,
one reference page

13 API groups · 76 endpoints · Auth, Invoicing, POS, Inventory, GST Returns, Accounting and more.

13API groups
76endpoints
RESTarchitecture
JWTauth method
URLhttps://subcidys.com/
All requests require Authorization: Bearer TOKEN

Authentication

6 endpoints

Register, login, logout and manage tokens. Supports email/password and Google OAuth. JWT access tokens expire in 15 minutes; refresh tokens allow seamless re-authentication.

Organization

2 endpoints

Manage your organization profile, business details, GSTIN, bank information, and KYC verification status. All data in Subcidys is scoped to an organization.

Users & Roles

8 endpoints

Manage team members within your organization. Assign roles (Business Admin, Accountant, Cashier, etc.) and control which modules each user can access.

Invoices

5 endpoints

Create and manage GST-compliant invoices and quotations. Handle the full lifecycle from DRAFT → PENDING → DUE → PAID. Supports partial payments, TDS, and customer portal actions.

Customer Portal

8 endpoints

Endpoints consumed by the customer-facing portal. Customers can view their invoices and quotations, accept or decline them, request payment date changes, and mark invoices as read.

Products & Inventory

5 endpoints

Manage your full product catalog. Each product supports SKU auto-generation, HSN/SAC codes, barcode and QR code, stock tracking with low-stock alerts, and GST rate assignment.

Customers

6 endpoints

Manage your customer database. Customers have billing and shipping addresses, GSTIN, and are linked to their invoices and POS transactions.

POS System

13 endpoints

Power the retail billing counter. Create Walk-In, Delivery, and Online orders. Manage tables, view kitchen order status, and pull analytics for today's session.

Accounting & Reports

7 endpoints

Access the accounting dashboard, generate Profit & Loss statements, Balance Sheets, Cash Flow reports, and GST summaries. All data is calculated live from your transactions.

GST Filing

5 endpoints

Generate and manage GSTR-1, GSTR-3B, and GSTR-9 returns directly from your invoices. Track filing status, download Excel files, and mark returns as filed with acknowledgment numbers.

Expenses

6 endpoints

Track business expenses by category, vendor, and payment method. Supports recurring expenses, tags, and receipt attachments. Bulk create via a single call.

Loan Applications

3 endpoints

Submit and track MSME credit applications. Applications can be linked to specific invoices for invoice financing. Super admins review and update application status.

Referral Codes

2 endpoints

Apply promotional referral codes to unlock additional module access or extended plan limits. Codes are created by super admins and applied by organizations at signup or in settings.

API Design

Consistent, predictable, REST

Every endpoint follows the same conventions. Once you know one, you know them all.

REST API

Standard HTTP verbs: GET, POST, PUT, PATCH, DELETE. JSON request and response bodies throughout.

JWT Authentication

Bearer token auth on every request. Access tokens expire in 15 min; refresh tokens allow silent renewal.

Multi-tenant scoped

All data is automatically scoped to your organizationId. No cross-org data leakage possible.

Idempotent PUTs

PUT requests are safe to retry. Duplicate calls with the same payload produce the same result.

Real-time stats

POS stats, today's sales, and accounting dashboards are computed live — no cache lag.

Role-gated endpoints

BUSINESS_ADMIN, ACCOUNTANT, CASHIER — every endpoint checks the caller's role before responding.

Date filtering

All list endpoints accept startDate and endDate query params in ISO 8601 format.

Bulk operations

Expenses support batch creation in a single call. Invoice items are always created inline with the parent.

Secured

100% Safe

Approval

Within 24 hrs

Disbursed

₹500 Cr+

Apply Free Today

Your loan, fully disbursed

Fast, unsecured business credit — apply online, get approved by AI, and receive funds within 48 hours.

Apply online

Fill the form in under 2 minutes — no branch visit needed.

01/04
02

Upload documents

02/04
03

Instant approval

03/04
04

Funds disbursed

04/04
No credit cardCancel anytimeFull module accessGuided onboarding

Included in every plan

GST Invoicing
Inventory
POS Billing
Analytics
GST Filing
CRM

+ 17 more modules — POS, CRM, Document Vault, EMI Calculator & more

"

Subcidys helped us get ₹25L in 48 hours — completely paperless. Best decision for our business growth.

PS

Priya Sharma

Sharma Textiles

✓ Verified

Businesses on Subcidys save an average of 8+ hours per week on invoicing and GST compliance.

Instant Check

Check eligibility now

Zero credit score impact · Under 2 minutes