We’re excited to launch our latest product to simplify your business processes. Know More →
GST RPACPC GST SuitePublic GST, e-Invoice & e-Way Bill

GST Taxpayer Search API – Retrieve GST Registration Details.

Retrieve available taxpayer and business registration information using a GSTIN through the RPACPC GST Taxpayer Search API. Access legal and trade names, registration status, taxpayer type, business constitution, e-Invoice status, nature of business, and principal and additional place-of-business details through a structured JSON response.

Sample verification Dummy data
1 You send
Checking
2 You get back
✓
ACTIVEValid & registered
482 ms
GSTIN27ABCDE1234F1Z5
Legal NameSAMPLE BUSINESS PRIVATE LIMITED
Trade NameSAMPLE BUSINESS
Registration StatusActive
Registration TypeRegular
Constitution of BusinessPrivate Limited Company
Registration Date10/05/2020
State JurisdictionSAMPLE STATE JURISDICTION
Central JurisdictionSAMPLE CENTRAL JURISDICTION
E-Invoice StatusYes
Principal Business AddressSAMPLE COMMERCIAL BUILDING, SAMPLE MAIN ROAD, SAMPLE AREA, Maharashtra - 400002
Nature of BusinessFactory / Manufacturing, Wholesale Business
API overview

Simplify GST Taxpayer Search Verification.

The RPACPC GST Taxpayer Search API retrieves GST registration and taxpayer information associated with a supplied GSTIN.
The API uses an HTTP GET request with query parameters and returns available taxpayer details, registration information, business activity categories, and address records.

Key Information Available

Access essential GST Taxpayer Search details.

The API response may include the following information, depending on the response received:

01
Taxpayer Identity

Legal name and trade name associated with the taxpayer.

legal_name
trade_name
02
GST Registration Details

GSTIN, registration date, last-updated date and registration status.

gstin
registration_date
last_updated_date
registration_status
03
Taxpayer Classification

Taxpayer type and constitution of the business.

taxpayer_type
constitution_of_business
04
e-Invoice Information

e-Invoice registration status returned by the source.

einvoice_status
05
Business Activities

Nature of business and additional business activities.

nature_of_business
additional_business_activities
06
Jurisdiction Details

State and central jurisdiction codes and names.

state_jurisdiction_code
state_jurisdiction
central_jurisdiction_code
central_jurisdiction
07
Business Addresses

Principal and additional places of business.

principal_address
additional_business_addresses
08
Location Information

Address components, PIN code and coordinates where available.

address_components
pincode
coordinates
The availability and completeness of individual fields depend on the response returned by the configured service.
How It Works

Simple API-based verification process.

Step 01

Authenticate with RPACPC

Complete the required authentication process using the RPACPC authentication API.

Step 02

Submit the GSTIN

Send a GET request with the required action and gstin query parameters.

Step 03

Retrieve Taxpayer Details

Receive the available GST registration and business information in the API response.

Step 04

Integrate the Response

Use the returned fields in business verification, vendor onboarding, and GST-related workflows.

API Request

Step 1 Submit GST Taxpayer Search API details.

Request parameters
Parameter Type Description
request_id String Unique identifier for the API request.
consent String Consent indicator for fetching information (Y/N).
consent_text String Consent declaration authorizing information retrieval via the RPACPC API.
gstNumber String GST Identification Number to verify.
The GSTIN above is illustrative. Authentication must be completed according to the RPACPC authentication requirements before calling the endpoint.
Sample request REQUEST
{
  "request_id": "11111111111",
  "consent": "Y",
  "consent_text": "I hereby declare my consent agreement for fetching my information via RPACPC API",
  "gstNumber": "27ABCDE1234F1Z5",
}
API response

Step 2Receive structured GST Taxpayer Search API information.

Key response fields
Parameter Type Description
status String Indicates the API response status, such as SUCCESS.
errdata Null/Object Error information returned by the API, if available.
data Object Contains GST registration and business details.
data.stjCd String State jurisdiction code.
data.lgnm String Legal name of the registered business.
data.stj String State jurisdiction name.
data.dty String GST registration type, such as Regular.
data.cxdt String Cancellation date, if available.
data.gstin String GST Identification Number.
data.einvoiceStatus String Indicates the e-invoicing status.
data.nba Array List of nature-of-business activities.
data.lstupdt String Date when the GST registration details were last updated.
data.rgdt String GST registration date.
data.ctb String Constitution of the business.
data.sts String Current GST registration status.
data.ctjCd String Central jurisdiction code.
data.ctj String Central jurisdiction name.
data.tradeNam String Trade name of the business.
data.adadr Array List of additional business addresses and their details.
data.adadr[].addr Object Structured address details for an additional business location.
data.adadr[].ntr Array Nature of business at the additional location.
data.pradr Object Principal place of business details.
data.pradr.addr Object Structured address of the principal business location.
data.pradr.ntr Array Nature of business at the principal location.
message String Message describing the API response.
requestid String Identifier associated with the API request.
sequenceId String Sequence identifier associated with the API transaction.
responseId String Unique identifier associated with the API response.
200 · Sample responseRESPONSE
{
  "status": "SUCCESS",
  "errdata": null,
  "data": {
    "stjCd": "STJ001",
    "lgnm": "SAMPLE BUSINESS PRIVATE LIMITED",
    "stj": "SAMPLE STATE JURISDICTION",
    "dty": "Regular",
    "cxdt": "",
    "gstin": "27ABCDE1234F1Z5",
    "einvoiceStatus": "Yes",
    "nba": [
      "Factory / Manufacturing",
      "Wholesale Business"
    ],
    "lstupdt": "15/01/2026",
    "rgdt": "10/05/2020",
    "ctb": "Private Limited Company",
    "sts": "Active",
    "ctjCd": "CTJ001",
    "ctj": "SAMPLE CENTRAL JURISDICTION",
    "tradeNam": "SAMPLE BUSINESS",
    "adadr": [
      {
        "addr": {
          "bnm": "SAMPLE BUSINESS COMPLEX",
          "st": "SAMPLE ROAD",
          "loc": "SAMPLE LOCALITY",
          "bno": "10",
          "stcd": "Maharashtra",
          "flno": "1ST FLOOR",
          "lt": "",
          "lg": "",
          "pncd": "400001"
        },
        "ntr": [
          "Wholesale Business"
        ]
      }
    ],
    "pradr": {
      "addr": {
        "bnm": "SAMPLE COMMERCIAL BUILDING",
        "st": "SAMPLE MAIN ROAD",
        "loc": "SAMPLE AREA",
        "bno": "20",
        "stcd": "Maharashtra",
        "flno": "2ND FLOOR",
        "lt": "",
        "lg": "",
        "pncd": "400002"
      },
      "ntr": [
        "Factory / Manufacturing"
      ]
    }
  },
  "message": "Dummy data fetched successfully",
  "requestid": "dummy-request-id-12345",
  "sequenceId": "dummy-sequence-id-12345",
  "responseId": "dummy-response-id-12345"
}

This is an illustrative response with synthetic data. Actual values, available address records, and optional fields may vary. The sample preserves the field names and nested structure of the supplied response schema.

Use cases

GST Taxpayer Search verification across business workflows.

Customer GST Verification

Retrieve available taxpayer identity and registration information during customer onboarding.

Vendor and Supplier Onboarding

Use legal names, trade names, registration status, and business addresses to support vendor record creation and verification.

Business Due Diligence

Incorporate GST registration information into business verification and counterparty assessment workflows.

Invoice and Billing Validation

Compare returned taxpayer information with business records used in invoicing and billing processes.

Multi-Location Business Records

Use principal and additional address records to support business profiles involving multiple places of business.

FAQ

Frequently asked questions

Common questions about the GST Taxpayer Search API — what it returns, how fast it is, and how to integrate.

Still have a question? Talk to an expert
What does the GST Taxpayer Search API do?
It retrieves available GST taxpayer and registration details using a GSTIN.
Which HTTP method does the API use?
The supplied endpoint uses the HTTP GET method.
Which query parameters are required?
The supplied request uses action and gstin.
What is the difference between GST Search and GST Taxpayer Search?
The previously supplied GST Search response contains GSTIN, state code, state name, registration status, and a validity indicator. The GST Taxpayer Search response contains additional fields, including legal and trade names, registration dates, taxpayer classification, jurisdiction, business activities, and addresses.
Does the API return principal and additional addresses?
Yes. The supplied schema includes pradr for the principal address and adadr as an array of additional address records.
What does einvoiceStatus represent?
It is the e-Invoice status value returned by the source. Confirm its possible values and interpretation before using it to make eligibility decisions.
Does the API confirm complete GST compliance?
No such conclusion can be drawn from this response alone. The supplied schema provides taxpayer and registration details, not a complete filing or compliance assessment.
Does the API require authentication?
According to the current integration design, authentication is completed before the internal API is called. The exact authentication procedure and headers will be documented separately.
Can the response contain multiple additional addresses?
Can the response contain multiple additional addresses?
Blog

Government ID Check API: How Does It Help Banks, FinTechs, and NBFCs Streamline KYC?

Government ID Check API helps banks, FinTechs, and NBFCs streamline KYC with faster identity verification and reduced manual work.

Read More
Government ID Check API: How Does It Help Banks, FinTechs, and NBFCs Streamline KYC?

India's verification infrastructure is already here.

Empower your applications with India's Enterprise Verification Intelligence Platform for faster, more reliable verification.