JustSwitch
API Access
Business Verification

Udyog Aadhaar API

POST /api/v1/gst-business/udyog-aadhaar

MSME Udyog Aadhaar / Udyam verification.

MSME Udyog Aadhaar / Udyam verification.

  • Real-time integrate for Aadhaar identity records with sub-300ms median latency
  • Production-grade REST JSON with sandbox & webhook support
  • UIDAI / NPCI / MCA aligned partner routing where applicable
  • Audit logs, idempotency keys & enterprise SLA on JustSwitch
Get API keys Developer docs
Latency
< 300 ms
Uptime SLA
99.9%
Format
REST / JSON
Sandbox
Included

What is Udyog Aadhaar?

MSME Udyog Aadhaar / Udyam verification.

Every request is authenticated with API keys, logged for audit, and routed through regulated partner rails where required. Responses follow a consistent `{ ok, data, message }` envelope so you can ship once and reuse the same error-handling patterns across all JustSwitch endpoints.

Whether you run a lending app, payment aggregator, or enterprise ERP, Udyog Aadhaar scales horizontally with rate limits tuned for burst traffic during campaigns.

Developers choose JustSwitch for Udyog Aadhaar because we aggregate multiple upstream providers behind one contract, one wallet settlement, and one support desk — so you launch faster while your compliance team retains full audit visibility through dashboard logs and exportable reports.

B2B onboarding Vendor management Procurement GST compliance

Technical specification

Endpoint details for Udyog Aadhaar integration on JustSwitch.

POST /api/v1/gst-business/udyog-aadhaar
Protocol HTTPS REST / JSON
Authentication Bearer API Key + IP allow-list
Sandbox Available — no live debits
Median latency < 300 ms
Rate limits Burst-friendly — contact for enterprise tiers
Webhooks Optional async notify
Idempotency reference_id recommended
API slug udyog-aadhaar

Request parameters

reference_id string required

Your unique transaction or session reference for reconciliation

consent boolean required

User consent flag — required for regulated KYC / verification flows

aadhaar_number string required

12-digit Aadhaar or VID — masked storage recommended

Response fields

status string

success | pending | failed

reference_id string

Echo of your request reference

verified_at datetime

ISO-8601 timestamp of completion

message string

Human-readable result or error detail

Key features

REST + JSON

HTTPS POST/GET with UTF-8 JSON bodies and predictable status codes.

Sandbox mode

Test end-to-end without debiting wallet or hitting live rails.

Webhooks

Async callbacks for pending states — payments, recharge, KYC, payouts.

Dashboard logs

Searchable request history with filters for support & audits.

Low latency

Median sub-300 ms for verification-class endpoints in production.

Enterprise SLA

99.9% uptime target with redundant routing and monitoring.

Who uses Udyog Aadhaar?

Fi

Fintech startups

Ship Aadhaar identity records features in days, not quarters.

En

Enterprises

Replace legacy screen-scraping with compliant APIs.

Sa

SaaS platforms

Embed verification inside your vertical workflow.

Sy

System integrators

Standardise client deliveries on one aggregator.

How it works

  1. 01

    Obtain sandbox keys from the JustSwitch developer console.

  2. 02

    POST input identifiers; handle validation errors in-line.

  3. 03

    Map response fields into your workflow & go live with production keys.

API reference

Request & response specification

Integrate Udyog Aadhaar through the JustSwitch REST API — parameters and sample JSON responses below.

Endpoint

POST https://console.justswitch.in/api/v1/gst-business/udyog-aadhaar

Content-Type

application/json

Developer console

Get API keys on console.justswitch.in →

Request headers

Header Type Description
Authorization required string Bearer token from your JustSwitch console API credentials
Content-Type required string application/json

Request body (JSON)

input string required

Primary input for Udyog Aadhaar API

Response examples

Sample JSON from the JustSwitch API for this service.

Success HTTP 200 
{
    "ok": true,
    "message": "Done Successfully",
    "data": {
        "service": "Udyog Aadhaar API"
    }
}
Failed / validation HTTP 422 
{
    "ok": false,
    "message": "Please check with all required parameters",
    "data": {
        "Errorcode": 104,
        "Status": "Failed",
        "Message": "Please check with all required parameters"
    }
}

Sample integration

Illustrative JSON for Udyog Aadhaar — see developer docs for live schemas.

POST Request
{
    "input": "XXXXXXXX",
    "reference_id": "REQ-2026-001",
    "consent": true
}
200 Response
{
    "ok": true,
    "message": "Success",
    "data": {
        "status": "success",
        "reference_id": "JS-MLEY5RTM",
        "verified_at": "2026-06-26T10:38:31+00:00"
    }
}

Business benefits

  • Reduce manual ops cost by up to 70% on verification-heavy journeys
  • Improve conversion with inline validation instead of offline turnaround
  • Single contract & settlement across 200+ Indian fintech APIs
  • Audit-ready logs exported from the admin console
  • Dedicated solutions engineering for enterprise rollouts

Frequently asked questions

What is Udyog Aadhaar used for?

It automates GST / E-Invoice workflows so your application can verify or transact in real time without building direct integrations with multiple upstream providers.

How do I integrate Udyog Aadhaar in my app?

Sign up on JustSwitch, obtain sandbox API keys, call the REST endpoint with JSON body, handle the unified response envelope, then switch to production keys after UAT sign-off.

How do I authenticate requests?

Use Bearer API keys from the JustSwitch dashboard. Sandbox and production keys are separated; rotate keys anytime without downtime.

Is there a sandbox for testing?

Yes — every API supports sandbox mode with simulated responses so engineering, QA, and compliance can sign off before go-live.

What about webhooks and async status?

Long-running operations (payments, recharge, some KYC steps) emit webhooks to your HTTPS endpoint with signed payloads for replay protection.

Is Udyog Aadhaar compliant for regulated use in India?

JustSwitch routes requests through authorised AUA/KUA, NPCI, MCA and partner networks. Your legal team should map consent, data retention and licence obligations to your use case.

Related GST / E-Invoice APIs

Explore more endpoints in the same verification category.

DIN Verification

The DIN Verification from JustSwitch lets product teams verify gst business data in real time through a single REST integration. Designed fo...

View API details →

GST Advance

The GST Advance from JustSwitch lets product teams integrate GSTIN & tax registrations in real time through a single REST integration. Desig...

View API details →

GST Return Status

The GST Return Status from JustSwitch lets product teams status GSTIN & tax registrations in real time through a single REST integration. De...

View API details →

GST Verification

The GST Verification from JustSwitch lets product teams verify GSTIN & tax registrations in real time through a single REST integration. Des...

View API details →

MCA CIN Search

The MCA CIN Search from JustSwitch lets product teams search company CIN records in real time through a single REST integration. Designed fo...

View API details →

MCA Company Search

The MCA Company Search from JustSwitch lets product teams search PAN / Income Tax identifiers in real time through a single REST integration...

View API details →

Start building with Udyog Aadhaar

Sandbox keys in minutes. Production access with compliance review for regulated endpoints.

Create free account Browse GST / E-Invoice