Search GSTIN

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/public/gstin/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "gstin": "05ABNTY3290P8ZB"
}
'

{
  "code": 200,
  "data": {
    "data": {
      "adadr": [],
      "ctb": "Partnership",
      "ctj": "JUBILEE HILLS - I",
      "ctjCd": "YN0703",
      "cxdt": "26/06/2023",
      "dty": "Regular",
      "einvoiceStatus": "No",
      "gstin": "36AEOFS9999J1ZI",
      "lgnm": "ACCOUNTS CONSULTANCY",
      "lstupdt": "17/09/2023",
      "nba": [
        "Supplier of Services"
      ],
      "pradr": {
        "addr": {
          "bnm": "",
          "bno": "FLAT 999, PLOT NO 3-123, ROAD NO 47",
          "dst": "Hyderabad",
          "flno": "NEAR YSR STATUE, 100 FEET ROAD",
          "geocodelvl": "NA",
          "landMark": "",
          "lg": "",
          "loc": "MADHAPUR",
          "locality": "",
          "lt": "",
          "pncd": "500081",
          "st": "FINANCE SOCIETY",
          "stcd": "Telangana"
        },
        "ntr": "Supplier of Services"
      },
      "rgdt": "18/11/2021",
      "stj": "MADHAPUR N 1",
      "stjCd": "TGC022",
      "sts": "Cancelled",
      "tradeNam": "ACCOUNTS CONSULTANCY"
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "f1b79b82-fdac-43e2-bd78-2324429b7dd4"
}

POST

gst

compliance

public

gstin

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/public/gstin/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "gstin": "05ABNTY3290P8ZB"
}
'

{
  "code": 200,
  "data": {
    "data": {
      "adadr": [],
      "ctb": "Partnership",
      "ctj": "JUBILEE HILLS - I",
      "ctjCd": "YN0703",
      "cxdt": "26/06/2023",
      "dty": "Regular",
      "einvoiceStatus": "No",
      "gstin": "36AEOFS9999J1ZI",
      "lgnm": "ACCOUNTS CONSULTANCY",
      "lstupdt": "17/09/2023",
      "nba": [
        "Supplier of Services"
      ],
      "pradr": {
        "addr": {
          "bnm": "",
          "bno": "FLAT 999, PLOT NO 3-123, ROAD NO 47",
          "dst": "Hyderabad",
          "flno": "NEAR YSR STATUE, 100 FEET ROAD",
          "geocodelvl": "NA",
          "landMark": "",
          "lg": "",
          "loc": "MADHAPUR",
          "locality": "",
          "lt": "",
          "pncd": "500081",
          "st": "FINANCE SOCIETY",
          "stcd": "Telangana"
        },
        "ntr": "Supplier of Services"
      },
      "rgdt": "18/11/2021",
      "stj": "MADHAPUR N 1",
      "stjCd": "TGC022",
      "sts": "Cancelled",
      "tradeNam": "ACCOUNTS CONSULTANCY"
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "f1b79b82-fdac-43e2-bd78-2324429b7dd4"
}

Headers

Authorization

string

required

JWT access token

x-accept-cache

boolean

Pass true to accept the cached response. If the header is not passed, or if false is sent as the value, the request will hit the origin.

x-api-key

string

required

API key for identification

x-api-version

string

default:1.0.0

API version

Body

application/json

gstin

string

required

GSTIN of the taxpayer

Response

200 Success / 200 Success / 200 SEZ / 200 ISD / 200 Multiple additional addresses of business / 200 Cancelled GSTIN / 200 Public Limited Company / 200 Public Sector Bank / FO8000 No records found / 200 NRI GSTIN

code

number

Example:

200

data

object

Show child attributes

data.data

object

Show child attributes

data.data.adadr

object[]

required

Show child attributes

data.data.adadr.addr

object

required

Show child attributes

data.data.adadr.addr.bnm

string

required

Building Name

Example:

"ELPHINSTONE BUILDING"

data.data.adadr.addr.bno

string

required

Building Number

Example:

"10"

data.data.adadr.addr.flno

string

required

Floor number

Example:

"1ST FLOOR"

data.data.adadr.addr.lg

string

required

longitude

Example:

"27.0238"

data.data.adadr.addr.loc

string

required

location

Example:

"FORT"

data.data.adadr.addr.lt

string

required

lattitude

Example:

"74.2179"

data.data.adadr.addr.pncd

string

required

Pincode

Example:

"249185"

data.data.adadr.addr.st

string

required

Street Name

Example:

"10, VEER NARIMAN ROAD"

data.data.adadr.addr.stcd

string

required

State Name

Example:

"Uttarakhand"

data.data.adadr.ntr

string[]

required

Nature of Additional place of business

Example:

["Wholesale Business"]

Example:

[
  {
    "addr": {
      "bnm": "ELPHINSTONE BUILDING",
      "bno": "10",
      "flno": "1ST FLOOR",
      "lg": "27.0238",
      "loc": "FORT",
      "lt": "74.2179",
      "pncd": "249185",
      "st": "10, VEER NARIMAN ROAD",
      "stcd": "Uttarakhand"
    },
    "ntr": ["Wholesale Business"]
  }
]

data.data.ctb

string

required

Constitution of Business

Example:

"Foreign LLP"

data.data.ctj

string

required

Center Jurisdiction

Example:

"BCP THUMMAKUNTA"

data.data.ctjCd

string

required

Center Jurisdiction Code

Example:

"AP004"

data.data.cxdt

string

required

Date Of Cancellation

Example:

""

data.data.dty

string

required

TaxPayer type

Example:

"Regular"

data.data.gstin

string

required

GST Identification Number

Example:

"05ABNTY3290P8ZB"

data.data.lgnm

string

required

Example:

"MS CORPORATION"

data.data.nba

string[]

required

Nature of Business Activity

Example:

[
  "Bonded Warehouse",
  "EOU / STP / EHTP",
  "Factory / Manufacturing",
  "Input Service Distributor (ISD)",
  "Leasing Business"
]

data.data.pradr

object

required

Show child attributes

data.data.pradr.addr

object

required

Show child attributes

data.data.pradr.addr.bnm

string

required

Building Name

Example:

"ELPHINSTONE BUILDING"

data.data.pradr.addr.bno

string

required

Building Number

Example:

"10"

data.data.pradr.addr.flno

string

required

Floor Number

Example:

"1ST FLOOR"

data.data.pradr.addr.lg

string

required

longitude

Example:

"27.0238"

data.data.pradr.addr.loc

string

required

Location

Example:

"FORT"

data.data.pradr.addr.lt

string

required

lattitude

Example:

"74.2179"

data.data.pradr.addr.pncd

string

required

Pincode

Example:

"249185"

data.data.pradr.addr.st

string

required

Street Name

Example:

"10, VEER NARIMAN ROAD"

data.data.pradr.addr.stcd

string

required

State Name

Example:

"Uttarakhand"

data.data.pradr.addr.dst

string

Example:

"Bengaluru Urban"

data.data.pradr.addr.geocodelvl

string

Example:

"NA"

data.data.pradr.addr.landMark

string

Example:

""

data.data.pradr.addr.locality

string

Example:

""

data.data.pradr.ntr

string[]

required

Nature of pricipal place of Business

Example:

["Wholesale Business"]

data.data.rgdt

string

required

Lst Updated Date

Example:

"05/05/2017"

data.data.stj

string

required

State Jurisdiction

Example:

"BCP KODIKONDA"

data.data.stjCd

string

required

State Jurisdiction Code

Example:

"AP003"

data.data.sts

string

required

GSTN status

Example:

"Provisional"

data.data.tradeNam

string

required

trade Name

Example:

"ALTON PLASTIC PRIVATE LTD"

data.data.canclDt

string

Example:

""

data.data.einvoiceStatus

string

eInvoice enablement status for GSTIN

Example:

"Yes"

data.data.lstupdt

string

Example:

"05/01/2017"

data.data.rsnCd

string

Example:

""

data.data.typeOfSup

string

Example:

"OIDAR"

data.error

object

Show child attributes

data.error.error_cd

string

Example:

"FO8000"

data.error.message

string

Example:

"No records found"

data.status_cd

string

Example:

"1"

timestamp

number

Example:

1763446641000

transaction_id

string

Example:

"b14e175f-a03a-4e61-8cf1-1853a12bbc21"

Poll Job

Track GST Returns

⌘I

Analytics

Compliance

Headers

Body

Response