AOP Services

GST Validation API Documentation

POST https://api.aopay.co.in/api/V1/Validation/GstNumber

The GST Validation API allows customers and partners to validate a GST Number and retrieve taxpayer registration details from GST records. The API can be used during merchant onboarding, KYC verification, compliance checks and business verification.

Features

Validate a GST Number.
Retrieve taxpayer registration details.
Verify GST registration status.
Fetch business constitution and principal address.
Retrieve GST return filing history.
Fetch registered Goods & Services (HSN/SAC) details.

Body Parameters

{
 "GSTNumber":"07ABCXXXXX1ZX",  
 "RegistrationID":"AOP-XXX"  
}

Request Parameters

Name	Type	Mandatory	Description
GSTNumber	String	Yes	GST Number to be validated.
RegistrationID	String	Yes	Registration ID provided during partner onboarding.

Responses

200

Response

200

RESPONSE BODY

object

Response

401

RESPONSE BODY

returnMessage string

401

412

Response

412

RESPONSE BODY

returnMessage string

Did this page help you? Yes No

Language

Shell

Python

Node

PHP

cURL

curl --location 'https://api.aopay.co.in/api/V1/Validation/GstNumber' \
--header 'Content-Type: application/json' \
--data  '{
   "GSTNumber": "07ABCXXXXX1ZX",
   "RegistrationID": "AOP-XXX"
}'

import requests
import json

url = 'https://api.aopay.co.in/api/V1/Validation/GstNumber'
payload = json.dumps({
    "GSTNumber": "07ABCXXXXX1ZX",
    "RegistrationID": "AOP-XXX"
}) 

headers = {
  "Content-type" : "application/json"
}

response = requests.request("POST", url, headers=headers, data=payload)

print (response.text)

var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://api.aopay.co.in/api/V1/Validation/GstNumber',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "GSTNumber": "07ABCXXXXX1ZX",
    "RegistrationID": "AOP-XXX"
  }) 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
});

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post,'https://api.aopay.co.in/api/V1/Validation/GstNumber')
var content = new StringContent(
  "{
    "GSTNumber": "07ABCXXXXX1ZX",
    "RegistrationID": "AOP-XXX"
  }",
  null,"application/json"
); 

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://api.aopay.co.in/api/V1/Validation/GstNumber',
  CURLOPT_RETURNTRANSFER =>  true,
  CURLOPT_ENCODING =>  '',
  CURLOPT_MAXREDIRS =>  "10",
  CURLOPT_TIMEOUT =>  0,
  CURLOPT_FOLLOWLOCATION =>  true,
  CURLOPT_HTTP_VERSION =>  CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =>  'POST',
  CURLOPT_POSTFIELDS =>  '{
    "GSTNumber": "07ABCXXXXX1ZX",
    "RegistrationID": "AOP-XXX"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE

{
    "http_response_code": "200",
    "client_ref_num": "TERFXXXX",
    "request_id": "07ae929d-76bb-4358-a1e1-f5103c41f5c8",
    "result_code": "101",
    "result": {
      "taxpayerDetails": {
          "ntcrbs": "SPO",
          "adhrVFlag": "Yes",
          "lgnm": "ABC TECHNOLOGY PRIVATE LIMITED",
          "stj": "Address",
          "dty": "Regular",
          "cxdt": "",
          "gstin": "07ABCXXXXX1ZX",
          "nba": [
                    "Office / Sale Office",
                    "Supplier of Services",
                    "Recipient of Goods or Services"
                 ],
           "ekycVFlag": "Not Applicable",
           "cmpRt": "NA",
           "rgdt": "24/07/2025",
           "ctb": "Private Limited Company",
           "pradr": {
                      "adr": "Address"
                    },
           "sts": "Active",
           "tradeNam": "ABC TECHNOLOGY PRIVATE LIMITED",
           "isFieldVisitConducted": "No",
           "ctj": "Address Details",
           "einvoiceStatus": "No"
         },
       "taxpayerReturnDetails": {
           "filingStatus": [
                {
                  "fy": "2026-2027",
                  "taxp": "May",
                  "mof": "ONLINE", 
                  "dof": "11/06/2026", 
                  "rtntype": "GSTR1",
                  "arn": "NA",
                  "status": "Filed"                      
                },
                {
                  "fy": "2026-2027",
                  "taxp": "April",
                  "mof": "ONLINE",
                  "dof": "28/05/2026", 
                  "rtntype": "GSTR1",
                  "arn": "NA",
                  "status": "Filed"                      
                },
                {
                  "fy": "2026-2027",
                  "taxp": "April",
                  "mof": "ONLINE",
                  "dof": "01/06/2026", 
                  "rtntype": "GSTR3B",
                  "arn": "NA",
                  "status": "Filed"                     
                }
              ]
            },
        "goods_service": {
            "bzgddtls": [],
            "bzsdtls": [
                {
                    "saccd": "9971",
                    "sdes": "Financial and related services"
                },
                {
                    "saccd": "997119",
                    "sdes": "Other financial services (except investment banking, insurance services and pension services)"
                },
                {
                    "saccd": "998312",
                    "sdes": "Business consulting services including public relations services"
                },
                {
                    "saccd": "998399",
                    "sdes": "Other professional, technical and business services nowhere else classified"
                }
            ],                       
         }
     }
}

 
{
    "returnMessage": "Unauthorized access. Please log in again."
}

 
{
   "returnMessage": "Invalid registration ID"
}

 
{
   "returnMessage": "Precondition failed. Please try again."
}