HomeAbout
Join Today
  • Sign Up
  • Sign In
Conatct Us
HomeAbout
Join Today
  • Sign Up
  • Sign In
Conatct Us
  1. Verification Suite
  • Introduction
  • Getting Started
  • Authentication
  • HTTPS Status Codes
  • Rate Limits
  • Verification Suite
    • Digilocker
      • Initiate
      • Check Status
      • Download Aadhaar
    • Aadhaar
      • Send OTP
      • Verify OTP
    • UPI Verification
      POST
    • Bank Verification
      POST
    • PAN Verification
      POST
    • GSTIN Verification
      POST
  • NSDL Account Opening
    • BC Agent Onboarding
      POST
    • Create Account
      POST
    • Account Status
      GET
  • Comunications API
    • Send SMS OTP
      POST
    • Send Whatsapp OTP
      POST
  1. Verification Suite

GSTIN Verification

POST
/api/v1/verification/gstin-verify

๐Ÿงพ GSTIN Verification#

Verify a business's GST registration status and fetch official details like legal name, business type, address, and registration status. Use this to ensure supplier authenticity, enable ITC claims, and maintain compliance before onboarding vendors or partners.

Request

Header Params

Body Params application/json

Example
{
    "gst_number": "29ABCDE1234F1Z5"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/verification/gstin-verify' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gst_number": "29ABCDE1234F1Z5"
}'

Responses

๐ŸŸข200Success
application/json
Body

Example
{
    "response_code": 200,
    "status": "success",
    "message": "Success",
    "data": {
        "request_id": "GSTVFR15231920251014_09268498",
        "status": "verified",
        "verification_type": "GSTIN",
        "gstin": "29ABCDE1234F1Z5",
        "legal_name": "John Doe",
        "trade_name": "IMB Payment",
        "registration_date": "20/11/2020",
        "last_updated": "20/01/2025",
        "gstin_status": "Active",
        "taxpayer_type": "Regular",
        "constitution_type": "Proprietorship",
        "einvoice_status": "No",
        "state_jurisdiction_code": "UP12454",
        "state_jurisdiction": "Noida Sector-3",
        "center_jurisdiction_code": "NY06532",
        "center_jurisdiction": "RANGE-I",
        "nature_of_business": [
            "Retail Business"
        ],
        "address": {
            "building_name": "",
            "building_number": "Noida",
            "floor_number": "",
            "street": "Noida",
            "location": "GT Road",
            "locality": "GT Road",
            "landmark": "GTRoad",
            "district": "Noida",
            "state": "Uttar Pradesh",
            "pincode": "200245",
            "latitude": "12.055443",
            "longitude": "53.2471770000001",
            "geocode_level": "pincode"
        },
        "address_nature_of_business": "Retail Business",
        "additional_addresses": [],
        "cancellation_date": "",
        "note": "GSTIN verification successful โ€” the registration is active and valid."
    },
    "meta": {
        "request_id": "48353703-a29f-47cc-9fce-27ed91036121",
        "time": "2025-10-14T15:23:19+05:30"
    }
}
๐ŸŸ 422Validation Error
Previous
PAN Verification
Next
BC Agent Onboarding
Built with