Developer Documentation

One API key, every product. Fund your prepaid wallet, send a request, and we route the call to the cheapest healthy vendor. Every product below ships an OpenAPI 3.1 reference, copy-paste code snippets and a sample response.

Getting started — read this first

Base URL: https://apisathi.in/gw/v1/<product-slug>/ — every call is POST, Content-Type: application/json.
Auth is one header only: X-API-Key: live_xxx. The tenant is resolved from the key — do not send an X-Tenant-ID header, it is not used.
Only integrate APIs that are actually live. The catalog lists some products not yet wired to a vendor. Fetch GET https://apisathi.in/api/v1/rates and use a product only when available: true. A not-live product returns 503 ROUTER_NO_VENDOR_AVAILABLE.
Test keys return SANDBOX MOCK data. A test_ key returns deterministic fake responses (e.g. a fixed sample identity for any input). Never treat a test-key response as real verification — validate every product on the live_ key before going live.
Prepaid wallet. Fund before use; an empty wallet returns 402 INSUFFICIENT_BALANCE. Failed vendor calls are auto-refunded (never charged).
Idempotency. Send Idempotency-Key: <uuid> per request for safe retries — same response for 24h, no double charge.
Set your HTTP client timeout to ≥ 15s — a few upstream lookups take 4–5s.

Response codes

200 success · 400 invalid payload (send only documented fields — additionalProperties:false)
401 missing/invalid key · 402 fund wallet · 429 rate-limited or duplicate — back off and retry
5xx / 503 vendor error or product not live — not charged, safe to retry

$ curl -X POST https://apisathi.in/gw/v1/gstin-basic-v1/ -H "X-API-Key: live_xxx" -H "Content-Type: application/json"

KYC & Verification

Vehicle RC Verificationvehicle-rc-v1

Fetch RC (Registration Certificate) details for a vehicle from VAHAN.

Credit & Bureau

Credit Report (Experian)credit-report-v1

Consumer credit report from Experian via mobile number with consent. API Sathi resolves the name from the mobile (name_lookup).

Masked Mobile Credit Reportmasked-mobile-report-v1

Credit report against a masked mobile number with consent (Experian, via API Sathi).

KYB & Company Validation

CIN to PANcin-to-pan-v1

Resolve the company PAN linked to a CIN.

Company Name to CINcompany-to-cin-v1

Resolve candidate CINs for a company name with match scores.

DIN Validation Basicdin-basic-v1

Validate a Director Identification Number and return director name and status.

DIN to PANdin-to-pan-v1

Resolve the PAN linked to a Director Identification Number (DIN).

GST Enhancedgst-enhanced-v1

Enhanced GSTIN intelligence: merchant details, contacts and business nature.

GSTIN Authentication Advancedgstin-verify-v1

Authenticate a GSTIN and return taxpayer details, return filings and places of business.

GSTIN Authentication Basicgstin-basic-v1

Authenticate a GSTIN and return core taxpayer details.

GSTIN Search by PANgstin-by-pan-v1

List all GSTINs registered against a PAN, optionally filtered by state.

GSTIN to Contact Detailsgstin-to-contact-v1

Fetch the registered mobile and email contact for a GSTIN.

Mobile to Udyam Lookupmobile-to-udyam-v1

Find Udyam (MSME) registrations linked to a mobile number.

PAN to CINpan-to-cin-v1

Resolve the company CIN and basics linked to a PAN.

PAN to DINpan-to-din-v1

Resolve the Director Identification Number (DIN) linked to a PAN.

Employment & Income

UAN Advanced V3uan-advanced-v3

Employment via UAN + EPFO last 3 months

UAN Advanced V4uan-advanced-v4

Employment history since 2012 + PF last 3 months

UAN Basic V3uan-basic-v3

Latest employment via UAN

UAN Basic V4uan-basic-v4

Employment history since 2012

Communication

SMS Transactionalsms-send-v1

Send a transactional SMS via approved DLT template.

Vehicle & Transport

RC e-Challan Detailsrc-challan

Pending traffic e-Challan details for a vehicle registration (RC) number, sourced from VAHAN/Parivahan. Returns the list of challans and a total count; a vehicle with no pending challans returns echallan_count 0.