> ## Documentation Index > Fetch the complete documentation index at: https://docs.privue.ai/llms.txt > Use this file to discover all available pages before exploring further. # GST registration > Verify a GSTIN is registered and return the registry's record of the business. ## OpenAPI ````yaml /suite/api-reference/openapi.json post /gst/v1/gst-info.1 openapi: 3.1.0 info: title: Privue API Suite version: 1.0.0 description: >- Business, tax, registry, employment and identity verification against official Indian sources, a person's own documents read through DigiLocker with their consent, and an EPF member's passbook read with the OTP they receive. **Authentication.** Every request takes your API key as a bearer token: `Authorization: Bearer `. **One envelope.** Every check returns the reasons behind a refusal and the record the source held, and an empty `reasons` means the check passed. Branch on `reasons` rather than on the status code, because a call the source answered returns `200` whatever it concluded. **DigiLocker and EPFO passbook.** A DigiLocker endpoint returns `details` alone: what it read, as the source holds it. So do submitting an EPFO passbook OTP and reading the passbook; sending the OTP answers like a check. **Versioning.** Each endpoint is versioned on its own, directly in its path. A new version of one endpoint never moves another, so no release requires migrating every integration at once. servers: - url: https://api.privue.ai description: Production security: - bearerAuth: [] tags: - name: Checks description: One check on one subject, answered in the envelope every check shares. - name: DigiLocker description: >- A person's own documents, read through the consent they give at DigiLocker. - name: EPFO passbook description: >- A member's EPF passbook, read with the OTP sent to the mobile number on their account. - name: Orchestrated flows description: Every check on one business, asked and answered together in a single call. - name: Usage description: What you have called, and when. paths: /gst/v1/gst-info.1: post: tags: - Checks summary: GST registration description: >- Verify a GSTIN is registered and return the registry's record of the business. operationId: gst.gst-info.1 requestBody: content: application/json: schema: $ref: '#/components/schemas/GstinRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/GstinResponse' examples: verified: summary: An active registration value: reasons: [] details: gstin: 27AAACE1234F1Z6 legal_name: EXAMPLE TECHNOLOGIES PRIVATE LIMITED trade_name: EXAMPLE TECH registration_date: '2017-07-01' cancellation_date: null registration_status: Active jurisdiction: state: >- STATE - MAHARASHTRA,ZONE - MUMBAI,DIVISION - EAST,CHARGE - ANDHERI_EAST_701 central: >- STATE - CBIC,ZONE - MUMBAI,COMMISSIONERATE - MUMBAI EAST,DIVISION - DIVISION IV primary_business_address: street: >- UNIT 402, 4TH FLOOR, TECH PARK, ANDHERI KURLA ROAD, ANDHERI EAST city: MUMBAI state: Maharashtra country: India postal_code: '400093' other_business_address: null business_constitution: Private Limited Company business_nature: - Supplier of Services - Office / Sale Office taxpayer_type: Regular e_invoice_mandated: true aggregate_turnover: 'Slab: Rs. 5 Cr. to 25 Cr.' authorized_signatory: - Rahul Mehta - Priya Nair business_details: goods_details: [] service_details: - service_description: >- Information technology (IT) design and development services sac_code: '998314' gross_total_income: 'Slab: Rs. 1 Cr. to 5 Cr.' gross_total_income_financial_year: 2024-25 filings: - return_type: GSTR3B financial_year: 2025-2026 tax_period: March status: Filed filing_date: '2026-04-20' mode_of_filing: ONLINE - return_type: GSTR1 financial_year: 2025-2026 tax_period: March status: Filed filing_date: '2026-04-11' mode_of_filing: ONLINE - return_type: GSTR3B financial_year: 2025-2026 tax_period: February status: Filed filing_date: '2026-03-27' mode_of_filing: ONLINE - return_type: GSTR1 financial_year: 2025-2026 tax_period: February status: Filed filing_date: '2026-03-10' mode_of_filing: ONLINE filing_summary: filings: - return_type: GSTR3B financial_year: 2025-2026 tax_period: March filing_date: '2026-04-20' status: Filed mode_of_filing: ONLINE due_date: '2026-04-20' days_late: 0 is_on_time: true - return_type: GSTR1 financial_year: 2025-2026 tax_period: March filing_date: '2026-04-11' status: Filed mode_of_filing: ONLINE due_date: '2026-04-11' days_late: 0 is_on_time: true - return_type: GSTR3B financial_year: 2025-2026 tax_period: February filing_date: '2026-03-27' status: Filed mode_of_filing: ONLINE due_date: '2026-03-20' days_late: 7 is_on_time: false - return_type: GSTR1 financial_year: 2025-2026 tax_period: February filing_date: '2026-03-10' status: Filed mode_of_filing: ONLINE due_date: '2026-03-11' days_late: 0 is_on_time: true total_filings: 4 overall: total: 4 filed: 4 not_filed: 0 on_time: 3 late: 1 on_time_percentage: 75 by_return_type: GSTR3B: total: 2 filed: 2 not_filed: 0 on_time: 1 late: 1 on_time_percentage: 50 GSTR1: total: 2 filed: 2 not_filed: 0 on_time: 2 late: 0 on_time_percentage: 100 by_financial_year: 2025-2026: total: 4 filed: 4 not_filed: 0 on_time: 3 late: 1 on_time_percentage: 75 inactive: summary: A cancelled registration value: reasons: - code: gstin-inactive message: This GST registration is not active. details: gstin: 27AAACE1234F1Z6 legal_name: EXAMPLE TECHNOLOGIES PRIVATE LIMITED trade_name: EXAMPLE TECH registration_date: '2017-07-01' cancellation_date: '2026-06-30' registration_status: Cancelled jurisdiction: state: >- STATE - MAHARASHTRA,ZONE - MUMBAI,DIVISION - EAST,CHARGE - ANDHERI_EAST_701 central: >- STATE - CBIC,ZONE - MUMBAI,COMMISSIONERATE - MUMBAI EAST,DIVISION - DIVISION IV primary_business_address: street: >- UNIT 402, 4TH FLOOR, TECH PARK, ANDHERI KURLA ROAD, ANDHERI EAST city: MUMBAI state: Maharashtra country: India postal_code: '400093' other_business_address: null business_constitution: Private Limited Company business_nature: - Supplier of Services - Office / Sale Office taxpayer_type: Regular e_invoice_mandated: true aggregate_turnover: 'Slab: Rs. 5 Cr. to 25 Cr.' authorized_signatory: - Rahul Mehta - Priya Nair business_details: goods_details: [] service_details: - service_description: >- Information technology (IT) design and development services sac_code: '998314' gross_total_income: 'Slab: Rs. 1 Cr. to 5 Cr.' gross_total_income_financial_year: 2024-25 filings: - return_type: GSTR3B financial_year: 2025-2026 tax_period: March status: Filed filing_date: '2026-04-20' mode_of_filing: ONLINE - return_type: GSTR1 financial_year: 2025-2026 tax_period: March status: Filed filing_date: '2026-04-11' mode_of_filing: ONLINE - return_type: GSTR3B financial_year: 2025-2026 tax_period: February status: Filed filing_date: '2026-03-27' mode_of_filing: ONLINE - return_type: GSTR1 financial_year: 2025-2026 tax_period: February status: Filed filing_date: '2026-03-10' mode_of_filing: ONLINE filing_summary: filings: - return_type: GSTR3B financial_year: 2025-2026 tax_period: March filing_date: '2026-04-20' status: Filed mode_of_filing: ONLINE due_date: '2026-04-20' days_late: 0 is_on_time: true - return_type: GSTR1 financial_year: 2025-2026 tax_period: March filing_date: '2026-04-11' status: Filed mode_of_filing: ONLINE due_date: '2026-04-11' days_late: 0 is_on_time: true - return_type: GSTR3B financial_year: 2025-2026 tax_period: February filing_date: '2026-03-27' status: Filed mode_of_filing: ONLINE due_date: '2026-03-20' days_late: 7 is_on_time: false - return_type: GSTR1 financial_year: 2025-2026 tax_period: February filing_date: '2026-03-10' status: Filed mode_of_filing: ONLINE due_date: '2026-03-11' days_late: 0 is_on_time: true total_filings: 4 overall: total: 4 filed: 4 not_filed: 0 on_time: 3 late: 1 on_time_percentage: 75 by_return_type: GSTR3B: total: 2 filed: 2 not_filed: 0 on_time: 1 late: 1 on_time_percentage: 50 GSTR1: total: 2 filed: 2 not_filed: 0 on_time: 2 late: 0 on_time_percentage: 100 by_financial_year: 2025-2026: total: 4 filed: 4 not_filed: 0 on_time: 3 late: 1 on_time_percentage: 75 not_registered: summary: No registration under the GSTIN value: reasons: - code: gstin-not-registered message: This GSTIN is not in the GST registry. details: null '401': description: The API key is missing, malformed or not valid. content: application/json: schema: $ref: '#/components/schemas/SuiteError' '403': description: The key is valid but is not entitled to this feature. content: application/json: schema: $ref: '#/components/schemas/SuiteError' '422': description: >- The request failed validation, or the source would not accept the details in it. content: application/json: schema: $ref: '#/components/schemas/SuiteError' '429': description: >- The key is not cleared for this feature, or is sending too many requests. Nothing was called. content: application/json: schema: $ref: '#/components/schemas/SuiteError' '503': description: >- The source could not be reached, or authentication is temporarily unavailable. content: application/json: schema: $ref: '#/components/schemas/SuiteError' default: description: The request failed content: application/json: schema: $ref: '#/components/schemas/SuiteError' components: schemas: GstinRequest: properties: gstin: type: string pattern: ^\d{2}[A-Z]{5}\d{4}[A-Z]{1}[A-Z\d]{1}Z[A-Z\d]{1}$ title: Gstin description: GST identification number to verify type: object required: - gstin title: GstinRequest description: The GSTIN to read from the GST registry. GstinResponse: properties: reasons: items: $ref: '#/components/schemas/Reason' type: array title: Reasons description: >- Why the check did not pass, worst first, each a stable code with the text for it. Empty when it passed details: anyOf: - $ref: '#/components/schemas/GstInfo' - type: 'null' description: The registry's record of the business type: object title: GstinResponse description: >- The GST registration behind a GSTIN; `details` is null when the registry holds none. SuiteError: properties: code: type: integer title: Code description: HTTP status code of the response timestamp: type: integer title: Timestamp description: Unix millisecond timestamp of when the response was produced message: type: string title: Message description: What went wrong, in one sentence type: object required: - code - timestamp - message title: SuiteError description: Why a request failed. Reason: properties: code: $ref: '#/components/schemas/ReasonCode' description: Stable code to branch on message: type: string title: Message description: What the code means, in one sentence type: object required: - code - message title: Reason description: One machine-readable reason a check did not pass. GstInfo: properties: gstin: type: string pattern: ^\d{2}[A-Z]{5}\d{4}[A-Z]{1}[A-Z\d]{1}Z[A-Z\d]{1}$ title: Gstin legal_name: type: string title: Legal Name trade_name: type: string title: Trade Name registration_date: type: string format: date title: Registration Date cancellation_date: anyOf: - type: string format: date - type: 'null' title: Cancellation Date registration_status: $ref: '#/components/schemas/GstinStatus' jurisdiction: $ref: '#/components/schemas/Jurisdiction' primary_business_address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' other_business_address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' business_constitution: $ref: '#/components/schemas/BusinessConstitution' business_nature: items: $ref: '#/components/schemas/NatureOfBusinessActivities' type: array title: Business Nature taxpayer_type: $ref: '#/components/schemas/TaxpayerType' e_invoice_mandated: type: boolean title: E Invoice Mandated aggregate_turnover: type: string title: Aggregate Turnover authorized_signatory: items: type: string type: array title: Authorized Signatory business_details: $ref: '#/components/schemas/BusinessDetails' gross_total_income: type: string title: Gross Total Income gross_total_income_financial_year: type: string title: Gross Total Income Financial Year filings: items: $ref: '#/components/schemas/RegistryFiling' type: array title: Filings filing_summary: anyOf: - $ref: '#/components/schemas/GstFilingSummary' - type: 'null' type: object required: - gstin - legal_name - trade_name - registration_date - cancellation_date - registration_status - jurisdiction - primary_business_address - other_business_address - business_constitution - business_nature - taxpayer_type - e_invoice_mandated - aggregate_turnover - authorized_signatory - business_details - gross_total_income - gross_total_income_financial_year - filings title: GstInfo description: >- What the GST registry holds against one GSTIN: the registration, and what it has since done. ReasonCode: type: string enum: - cin-not-registered - gstin-not-registered - gstin-inactive - pan-inactive - pan-name-mismatch - pan-date-of-birth-mismatch - udyam-not-registered - udyam-not-registered-for-pan - udyam-cancelled - gst-not-registered-for-pan - company-not-registered-for-pan - epfo-member-not-found - uan-not-registered-for-pan - driving-licence-not-registered - driving-licence-details-mismatch - driving-licence-expired - uan-not-registered-for-mobile - passport-not-registered - passport-name-mismatch - source-unavailable - details-refused - bank-account-unverified - bank-account-unsettled title: ReasonCode description: >- Why a check did not pass, as the stable code a client branches on. Declared rather than written as strings so that every code a check can answer with reaches the published schema, and a client reads the whole set from the API reference. GstinStatus: type: string enum: - Active - Inactive - Cancelled - Active pending Verification - Suspended - Cancelled due to expiry of registration period - Cancelled on Request of Taxpayer - Cancelled on application of Taxpayer - Cancelled suo-moto - Not Migrated - Unknown title: GstinStatus description: The standing of a GST registration. Jurisdiction: properties: state: type: string title: State central: type: string title: Central type: object required: - state - central title: Jurisdiction description: GST jurisdiction information. Address: properties: street: type: string title: Street city: type: string title: City state: $ref: '#/components/schemas/State' country: $ref: '#/components/schemas/Country' default: India postal_code: type: string title: Postal Code type: object required: - street - city - state - postal_code title: Address description: A postal address. BusinessConstitution: type: string enum: - Sole Proprietorship - Partnership - Hindu Undivided Family - Private Limited Company - Public Limited Company - One Person Company - Limited Liability Partnership - Foreign Limited Liability Partnership - Foreign Company - Unlimited Company - Public Sector Undertaking - Society/ Club/ Trust/ AOP - Government Department - Local Authority - Statutory Body - Trust - Others title: BusinessConstitution description: >- The legal form a business is registered under, named as the registry names it. OTHERS carries a constitution the registry states and this list does not name, so a form outside it is still recorded as a registration rather than refused. NatureOfBusinessActivities: type: string enum: - Input Service Distributor (ISD) - Bonded Warehouse - SEZ - Leasing Business - Service Provision - Import - Works Contract - Others - Office / Sale Office - EOU / STP / EHTP - Factory / Manufacturing - Recipient of Goods or Services - Retail Business - Supplier of Services - Wholesale Business - Warehouse / Depot - Export title: NatureOfBusinessActivities description: >- A way a registration is registered to operate. Most registrations name more than one. TaxpayerType: type: string enum: - Regular - Tax Deductor - Tax Collector (Electronic Commerce Operator) - Composition - Exempted - SEZ Unit - Casual Taxable Person - Input Service Distributor (ISD) - Unregistered Applicant - SEZ Developer - Consulate or Embassy of Foreign Country - United Nation Body - Other Notified Person - Non-Resident Online Services Provider - Unknown title: TaxpayerType description: >- How a registration taxes the business it belongs to. UNKNOWN carries a type the registry states and this list does not name, so a registration under one is still recorded rather than refused. BusinessDetails: properties: goods_details: items: $ref: '#/components/schemas/GoodsDetail' type: array title: Goods Details service_details: items: $ref: '#/components/schemas/ServiceDetail' type: array title: Service Details type: object title: BusinessDetails description: Business detail information. RegistryFiling: properties: return_type: type: string title: Return Type financial_year: type: string title: Financial Year tax_period: type: string title: Tax Period status: type: string title: Status filing_date: anyOf: - type: string format: date - type: 'null' title: Filing Date mode_of_filing: anyOf: - type: string - type: 'null' title: Mode Of Filing type: object required: - return_type - financial_year - tax_period - status - filing_date title: RegistryFiling description: >- One return as the GST registry lists it, of whatever type and period. Held verbatim beside ``GstFilingSummary``, which scores only the monthly GSTR1 and GSTR3B returns: the annual and quarterly types have no due date to rate them against, so they are recorded here rather than folded into a compliance rollup that would count them without being able to judge them. A return the registry lists as not filed carries no filing date. GstFilingSummary: properties: filings: items: $ref: '#/components/schemas/GstFiling' type: array title: Filings total_filings: type: integer title: Total Filings default: 0 overall: $ref: '#/components/schemas/GstFilingTypeRollup' by_return_type: additionalProperties: $ref: '#/components/schemas/GstFilingTypeRollup' type: object title: By Return Type by_financial_year: additionalProperties: $ref: '#/components/schemas/GstFilingTypeRollup' type: object title: By Financial Year type: object title: GstFilingSummary description: >- The monthly GSTR1 and GSTR3B returns rated for lateness, with compliance rollups over them. Narrower than ``GstInfo.filings`` and deliberately so: the two monthly types are the ones a rollup covers whichever source answered, so only these carry ``days_late``. The annual and quarterly types are held on ``GstInfo.filings`` as the registry stated them, unrated. State: type: string enum: - Andaman and Nicobar Islands - Andhra Pradesh - Arunachal Pradesh - Assam - Bihar - Chandigarh - Chhattisgarh - Dadra and Nagar Haveli and Daman and Diu - Delhi - Goa - Gujarat - Haryana - Himachal Pradesh - Jammu and Kashmir - Jharkhand - Karnataka - Kerala - Lakshadweep - Ladakh - Madhya Pradesh - Maharashtra - Manipur - Meghalaya - Mizoram - Nagaland - Odisha - Puducherry - Punjab - Rajasthan - Sikkim - Tamil Nadu - Telangana - Tripura - Uttar Pradesh - Uttarakhand - West Bengal title: State description: A state. Country: type: string enum: - India title: Country description: A country. GoodsDetail: properties: goods_description: type: string title: Goods Description hsn_code: type: string title: Hsn Code type: object required: - goods_description - hsn_code title: GoodsDetail description: Goods detail information. ServiceDetail: properties: service_description: type: string title: Service Description sac_code: type: string title: Sac Code type: object required: - service_description - sac_code title: ServiceDetail description: Service detail information. GstFiling: properties: return_type: type: string title: Return Type financial_year: type: string title: Financial Year tax_period: type: string title: Tax Period filing_date: anyOf: - type: string format: date - type: 'null' title: Filing Date status: type: string title: Status mode_of_filing: anyOf: - type: string - type: 'null' title: Mode Of Filing due_date: anyOf: - type: string format: date - type: 'null' title: Due Date days_late: anyOf: - type: integer - type: 'null' title: Days Late is_on_time: anyOf: - type: boolean - type: 'null' title: Is On Time type: object required: - return_type - financial_year - tax_period - filing_date - status - due_date title: GstFiling description: >- A single GST return filing for GSTR1 or GSTR3B, rated for lateness by whoever built it. A return left unrated is one nobody judged, which reads as that and is left out of a rollup's percentage. Nothing here fills the rating in, so a source that rates its own returns and then stops saying so is visible rather than answered for. A return carrying a rating and no due date is rated all the same. The registry moves a due date about, and a source that judged a filing without telling us the date it judged it against has still judged it. GstFilingTypeRollup: properties: total: type: integer title: Total default: 0 filed: type: integer title: Filed default: 0 not_filed: type: integer title: Not Filed default: 0 on_time: type: integer title: On Time default: 0 late: type: integer title: Late default: 0 on_time_percentage: anyOf: - type: number - type: 'null' title: On Time Percentage type: object title: GstFilingTypeRollup description: Aggregate filing counts and on-time percentage for a return type or FY. securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.