POSTGST Verification

Verify GSTIN details instantly — legal name, trade name, status, address, and filing metadata — for vendor onboarding and compliance checks.

POST/tools/kyc/gstin

The GST Verification API validates a GSTIN against official government records and returns the full registration profile: legal and trade names, taxpayer type, constitution of business, nature of activities, registration and last-update dates, state and centre jurisdiction, and the principal place of address (both as a flat string and as structured address components). Designed for KYB, vendor/merchant onboarding, compliance due diligence, and high-volume B2B verification pipelines.

Body parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200
`client_ref_id`	string	optional	Unique reference id per API call, generated by your system.e.g. REQ-20260101-001
`gstin`	string	required	Goods and Services Tax Identification Number of the business to verify (15-character alphanumeric).e.g. 29ABCDE1234F1Z5
`business_name`	string	required	Name of the business associated with the GSTIN (max 100 characters). Used for cross-reference in the verification response.e.g. Acme Pvt Ltd

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

client_ref_idstringoptional

Unique reference id per API call, generated by your system.

example: REQ-20260101-001

gstinstringRequired

Goods and Services Tax Identification Number of the business to verify (15-character alphanumeric).

example: 29ABCDE1234F1Z5

business_namestringRequired

Name of the business associated with the GSTIN (max 100 characters). Used for cross-reference in the verification response.

example: Acme Pvt Ltd

Headers

Field	Type	Required	Description
`developer_key`	string	required	Static API key issued to your account after KYC.
`secret-key`	string	required	Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).
`secret-key-timestamp`	string	required	Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.
`content-type`	string	required	application/jsone.g. application/json

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- gstinstring
  The GSTIN that was verified, echoed back from the government source.
- validboolean
  True if the GSTIN was found and is a valid registered number; false otherwise.
- gst_in_statusstring
  Current registration status of the GSTIN (e.g. Active, Cancelled, Suspended).
- legal_name_of_businessstring
  Official legal name of the business as registered with GST authorities.
- taxpayer_typestring
  Classification of the taxpayer (e.g. Regular, Composition, Non-resident, Casual Taxable Person).
- constitution_of_businessstring
  Legal structure / constitution of the business (e.g. Private Limited Company, Proprietorship, Partnership).
- date_of_registrationstring
  Date on which the GSTIN was registered (DD/MM/YYYY format).
- last_update_datestring
  Date of the most recent update to the GST registration record (DD/MM/YYYY format).
- cancellation_datestring
  Date of cancellation of the GST registration, if applicable. Empty string or null for active registrations.
- nature_of_business_activitiesstring
  Comma-separated list of business activity categories as declared during GST registration (e.g. Wholesale, Supplier of Services, Recipient of Goods or Services).
- state_jurisdictionstring
  State GST authority / jurisdiction under which the GSTIN is registered.
- center_jurisdictionstring
  Central GST authority / jurisdictional commissionerate for the registered business.
- principal_place_addressstring
  Principal place of business address as a single formatted string.
- principal_place_split_addressobject
  Principal place of business address broken into structured components.
  - flat_numberstring
    Flat, door, or unit number.
  - building_namestring
    Name of the building or premises.
  - streetstring
    Street or road name.
  - locationstring
    Locality or neighbourhood identifier.
  - citystring
    City name.
  - districtstring
    District name.
  - statestring
    State name.
  - pincodestring
    Postal / ZIP code.
  - latitudenumber
    Geographic latitude of the principal place of business.
  - longitudenumber
    Geographic longitude of the principal place of business.
- additional_address_arrayarray
  Array of additional registered places of business. Each element has the same structure as principal_place_split_address plus a flat address string.
  - flat_numberstring
    Flat, door, or unit number of the additional address.
  - building_namestring
    Building name of the additional address.
  - streetstring
    Street of the additional address.
  - locationstring
    Locality of the additional address.
  - citystring
    City of the additional address.
  - districtstring
    District of the additional address.
  - statestring
    State of the additional address.
  - pincodestring
    Pincode of the additional address.
- messagestring
  Verification result message from the data source.
- status_codenumber
  Internal status code from the upstream GST data source.