---
title: "GST registration lookup"
method: POST
path: "/kyc/gst/search"
tags: ["gst"]
---

# GST registration lookup

`POST /kyc/gst/search`

## Request

- Base URL: `https://api.qorpiq.com`
- URL: `https://api.qorpiq.com/kyc/gst/search`
- Auth: API key in header `x-api-key`

Full GST taxpayer record for a GSTIN - legal/trade name, status, constitution, registration date, jurisdictions, principal + additional places of business, and nature-of-business activities.

## Request body

- GstGstinRequest
  - `gstin` string, required: 15-character GSTIN.

## Response `200`

Success.

- GstSearchResponse
  - `transaction_id` string, uuid
  - `check` string
  - `gstin` string
  - `registration` GstRegistration: Full GST taxpayer record. Absent/empty fields are omitted.
    - `gstin` string
    - `pan` string
    - `legal_name` string
    - `trade_name` string
    - `status` string
    - `constitution_of_business` string
    - `taxpayer_type` string
    - `registration_date` string, date
    - `last_updated` string, date
    - `cancellation_date` string, date
    - `e_invoice_status` string
    - `state` string
    - `state_code` string
    - `nature_of_business_activities` string[]
    - `state_jurisdiction` GstJurisdiction
      - `code` string
      - `name` string
    - `center_jurisdiction` GstJurisdiction
      - `code` string
      - `name` string
    - `principal_address` GstAddress: A GST place of business. Empty fields are omitted.
      - `door_number` string
      - `building_name` string
      - `floor_number` string
      - `street` string
      - `location` string
      - `locality` string
      - `landmark` string
      - `district` string
      - `state` string
      - `pincode` string
      - `nature_of_business` string
    - `additional_addresses` GstAddress[]
      - `door_number` string
      - `building_name` string
      - `floor_number` string
      - `street` string
      - `location` string
      - `locality` string
      - `landmark` string
      - `district` string
      - `state` string
      - `pincode` string
      - `nature_of_business` string
  - `timestamp` integer

## Other responses

- `400`: Invalid GSTIN or request body.
- `401`: Missing or invalid x-api-key.
- `402`: Balance too low for this call. Add money to your QorpIQ balance to continue (reason credit_balance_exhausted is kept for compatibility).
- `404`: No GST registration found for that GSTIN.
- `503`: GST data source temporarily unavailable.

---

[API](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api.md) · [All operations](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/revisions/5a9c792b6c06?raw)