GST Basic

Business & KYB

Verifies a GSTIN and returns taxpayer registration details - legal/trade name, status, constitution, registration date, address and filing status.

Endpoint

POST https://app.emver.io/api/sandbox/v1/gst-basic

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`gst_basic_gstin` required	string	GSTIN

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/gst-basic \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "gst_basic_gstin": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/gst-basic",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "gst_basic_gstin": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/gst-basic", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "gst_basic_gstin": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/gst-basic', {
        "gst_basic_gstin": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING
}

Example · 200

{
  "status": 200,
  "message": "string"
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

GST Basic

Verifies a GSTIN and returns taxpayer registration details - legal/trade name, status, constitution, registration date, address and filing status.

Endpoint

POST /api/v1/gst-basic
Content-Type: application/json

Request parameters

Field	Required	Description
`gst_basic_gstin`	Yes	GSTIN. Example: `27AAACX1234A1Z5`

Sample request

{
  "gst_basic_gstin": "27AAACX1234A1Z5"
}

Sample success response

{
  "status": 200,
  "message": "Verification successful",
  "data": {
    "gstin": "...",
    "trade_name": "...",
    "legal_name": "...",
    "constitution_of_business": "...",
    "gst_status": "...",
    "taxpayer_type": "...",
    "nature_of_core_business": "...",
    "registration_date": "...",
    "cancellation_date": "...",
    "nature_of_business_activities": "...",
    "principal_address": "...",
    "aadhaar_authenticated": "...",
    "ekyc_verified": "...",
    "composition_rate": "...",
    "field_visit_conducted": "...",
    "state_jurisdiction": "...",
    "centre_jurisdiction": "...",
    "einvoice_status": "...",
    "return_filing": "...",
    "goods_and_services": "..."
  }
}

Sample error response

{
  "status": 404,
  "message": "No record found for the given input"
}

Response status codes

The status field in the response body indicates the verification outcome.

status	Meaning
`200`	Verification successful
`400`	Invalid input / verification failed
`404`	No record found
`422`	Invalid or missing input parameters
`500`	Source unavailable - retry later