# Gstin Verification

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/documentVerification/validate-gstin/{gstin}:
    get:
      summary: Gstin Verification
      deprecated: false
      description: ''
      tags:
        - Verification Suite/APIs - Verification Suite /GSTN Verification
      parameters:
        - name: gstin
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: apiName
          in: query
          description: ''
          required: false
          example: GSTIN_AUTHENTICATION_ADDITIONAL_DATA
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_code:
                    type: integer
                  response_message:
                    type: string
                  payload:
                    type: object
                    properties:
                      gstin:
                        type: string
                        x-apidog-mock: '{{$string.alphanumeric}}'
                      status:
                        type: string
                      legalNameOfBusiness:
                        type: string
                      tradeName:
                        type: string
                      companyName:
                        type: string
                      centreJurisdiction:
                        type: string
                      stateJurisdiction:
                        type: string
                      dateOfRegistration:
                        type: string
                      constitutionOfBusiness:
                        type: string
                      taxPayerType:
                        type: string
                      gstinStatus:
                        type: string
                      dateOfCancellation:
                        type: string
                      dateOfLastUpdated:
                        type: string
                      natureOfBusinessActivities:
                        type: array
                        items:
                          type: string
                      natureOfBusinessActivitiesString:
                        type: string
                      proprietors:
                        type: array
                        items:
                          type: string
                      division:
                        type: string
                      segment:
                        type: string
                      subSegment:
                        type: string
                      fieldVisitConducted:
                        type: string
                      address:
                        type: string
                      email:
                        type: string
                      mobile:
                        type: string
                      id:
                        type: integer
                      aggregateTurnovers:
                        type: array
                        items:
                          type: object
                          properties:
                            turnover:
                              type: string
                            financialYear:
                              type: string
                          x-apidog-orders:
                            - turnover
                            - financialYear
                      aggregateTurnover:
                        type: string
                      aggregateTurnoverFinancialYear:
                        type: string
                      aadhaarAuthenticated:
                        type: boolean
                      transactionDelays:
                        type: array
                        items:
                          type: object
                          properties:
                            returnYearMonth:
                              type: string
                            revisedDueDateOfFiling:
                              type: string
                            dateOfFiling:
                              type: string
                            noOfDaysOfDelay:
                              type: integer
                            returnType:
                              type: string
                            arn:
                              type: string
                          x-apidog-orders:
                            - returnYearMonth
                            - revisedDueDateOfFiling
                            - dateOfFiling
                            - noOfDaysOfDelay
                            - returnType
                            - arn
                      parsedName:
                        type: string
                      pinCode:
                        type: string
                      pan:
                        type: string
                      vintageInYears:
                        type: integer
                      vintageInMonths:
                        type: integer
                    required:
                      - gstin
                      - status
                      - legalNameOfBusiness
                      - tradeName
                      - companyName
                      - centreJurisdiction
                      - stateJurisdiction
                      - dateOfRegistration
                      - constitutionOfBusiness
                      - taxPayerType
                      - gstinStatus
                      - dateOfCancellation
                      - dateOfLastUpdated
                      - natureOfBusinessActivities
                      - natureOfBusinessActivitiesString
                      - proprietors
                      - division
                      - segment
                      - subSegment
                      - fieldVisitConducted
                      - address
                      - email
                      - mobile
                      - id
                      - aggregateTurnovers
                      - aggregateTurnover
                      - aggregateTurnoverFinancialYear
                      - aadhaarAuthenticated
                      - transactionDelays
                      - parsedName
                      - pinCode
                      - pan
                      - vintageInYears
                      - vintageInMonths
                    x-apidog-orders:
                      - gstin
                      - status
                      - legalNameOfBusiness
                      - tradeName
                      - companyName
                      - centreJurisdiction
                      - stateJurisdiction
                      - dateOfRegistration
                      - constitutionOfBusiness
                      - taxPayerType
                      - gstinStatus
                      - dateOfCancellation
                      - dateOfLastUpdated
                      - natureOfBusinessActivities
                      - natureOfBusinessActivitiesString
                      - proprietors
                      - division
                      - segment
                      - subSegment
                      - fieldVisitConducted
                      - address
                      - email
                      - mobile
                      - id
                      - aggregateTurnovers
                      - aggregateTurnover
                      - aggregateTurnoverFinancialYear
                      - aadhaarAuthenticated
                      - transactionDelays
                      - parsedName
                      - pinCode
                      - pan
                      - vintageInYears
                      - vintageInMonths
                required:
                  - response_code
                  - response_message
                  - payload
                x-apidog-orders:
                  - response_code
                  - response_message
                  - payload
              example:
                response_code: 0
                response_message: string
                payload:
                  gstin: string
                  status: UNVERIFIED
                  legalNameOfBusiness: string
                  tradeName: string
                  companyName: string
                  centreJurisdiction: string
                  stateJurisdiction: string
                  dateOfRegistration: '2025-01-22'
                  constitutionOfBusiness: string
                  taxPayerType: string
                  gstinStatus: string
                  dateOfCancellation: '2025-01-22'
                  dateOfLastUpdated: '2025-01-22'
                  natureOfBusinessActivities:
                    - string
                  natureOfBusinessActivitiesString: string
                  proprietors:
                    - string
                  division: string
                  segment: string
                  subSegment: string
                  fieldVisitConducted: string
                  address: string
                  email: string
                  mobile: string
                  id: 0
                  aggregateTurnovers:
                    - turnover: string
                      financialYear: string
                  aggregateTurnover: string
                  aggregateTurnoverFinancialYear: string
                  aadhaarAuthenticated: true
                  transactionDelays:
                    - returnYearMonth: string
                      revisedDueDateOfFiling: string
                      dateOfFiling: string
                      noOfDaysOfDelay: 0
                      returnType: string
                      arn: string
                  parsedName: string
                  pinCode: string
                  pan: string
                  vintageInYears: 0
                  vintageInMonths: 0
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Verification Suite/APIs - Verification Suite /GSTN Verification
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-18880710-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```