The GST Verification – Initiate API is used to start the verification process for a given GST Identification Number (GSTIN). This API validates the provided GSTIN and creates a verification request in the system. Upon successful initiation, the API returns a unique request_id which can be used to track and fetch the final verification result through the corresponding status or result API.This API is designed for asynchronous verification, meaning the verification process may take some time to complete. Clients are expected to store the returned request_id and query the verification status separately.
Represents the remaining credits available for use.
Example:
4040
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"KonnectNXT","colors":{"primary":"#005eff","light":"#005eff","dark":"#005eff"},"favicon":"https://mintcdn.com/konnectnxt-599b559e/VLKjQdtWPUg5a3yC/favicon.svg?fit=max\u0026auto=format\u0026n=VLKjQdtWPUg5a3yC\u0026q=85\u0026s=997af184ab83582a14443eec928e2736","logo":{"light":"https://mintcdn.com/konnectnxt-599b559e/cyfEQxBdIVhYMC5i/logo/light.png?fit=max\u0026auto=format\u0026n=cyfEQxBdIVhYMC5i\u0026q=85\u0026s=2698d3d46a93990f38aa74081cd25a57","dark":"https://mintcdn.com/konnectnxt-599b559e/cyfEQxBdIVhYMC5i/logo/dark.png?fit=max\u0026auto=format\u0026n=cyfEQxBdIVhYMC5i\u0026q=85\u0026s=d31b61f5c4c846883596cd4139d42c1b"},"api":{"mdx":{"server":"https://bgv.konnectnxt.com/api","auth":{"method":"bearer","name":null}}},"navbar":{"links":[{"label":"Support","href":"mailto:support@konnectnxt.com"}],"primary":{"type":"button","label":"Request Demo","href":"https://konnectnxt.com/contact-us"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/konnectnxt","website":"http://konnectnct.com"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Terms \u0026 Conditions","href":"https://konnectnxt.com/terms-and-conditions","icon":{"name":"file","style":"light"}},{"anchor":"Privacy Policy","href":"https://konnectnxt.com/privacy-policy","icon":{"name":"lock","style":"light"}}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"konnectnxt-599b559e","hasAudioNarration":false,"actualSubdomain":"konnectnxt-599b559e","customDomains":["docs.konnectnxt.com"],"gitSource":{"type":"github","owner":"j471n","repo":"knxt-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6ae9237aebe6959d239e3f85:success","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":38},{"language":"default","tag":"Background Verification","count":17},{"language":"default","tag":"Identity Verification","count":7},{"language":"default","tag":"Documentation","count":5},{"language":"default","tag":"Business Verification","count":4},{"language":"default","tag":"OCR APIs","count":4},{"language":"default","tag":"BGV Submit V2","count":3},{"language":"default","tag":"GST Verification","count":3},{"language":"default","tag":"Employment","count":3},{"language":"default","tag":"Financial APIs","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/business-verification/gst-verification/initiate","slug":"/api-reference/business-verification/gst-verification/initiate","pageMetadata":{"title":"Initiate","openapi":"POST /gst/initiate","description":"Initiates a GST verification request.\nThe response returns a `request_id` which should be used to fetch the verification result.\n","href":"/api-reference/business-verification/gst-verification/initiate"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Initiates a GST verification request.\\nThe response returns a \", _jsx(_components.code, {\n children: \"request_id\"\n }), \" which should be used to fetch the verification result.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,hr:`hr`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`GST Verification – Initiate API`}),` is used to start the verification process for a given `,_jsx(_components.strong,{children:`GST Identification Number (GSTIN)`}),`. This API validates the provided GSTIN and creates a verification request in the system. Upon successful initiation, the API returns a unique `,_jsx(_components.code,{children:`request_id`}),` which can be used to `,_jsx(_components.strong,{children:`track and fetch the final verification result`}),` through the corresponding status or result API.`]}),`\n`,_jsxs(_components.p,{children:[`This API is designed for `,_jsx(_components.strong,{children:`asynchronous verification`}),`, meaning the verification process may take some time to complete. Clients are expected to store the returned `,_jsx(_components.code,{children:`request_id`}),` and query the verification status separately.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsx(_components.p,{children:`This API is commonly used in scenarios such as:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Business onboarding and KYC verification`}),`\n`,_jsx(_components.li,{children:`Vendor or supplier validation`}),`\n`,_jsx(_components.li,{children:`Background verification (BGV) workflows`}),`\n`,_jsx(_components.li,{children:`Compliance and regulatory checks`}),`\n`,_jsx(_components.li,{children:`Automated GST authenticity validation in enterprise systems`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`important-notes`,children:`Important Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`This API `,_jsx(_components.strong,{children:`only initiates`}),` the GST verification process.`]}),`\n`,_jsx(_components.li,{children:`The actual verification result is not returned immediately.`}),`\n`,_jsxs(_components.li,{children:[`Always store the returned `,_jsx(_components.code,{children:`request_id`}),` and use it with the GST Verification Status/Result API to retrieve the final verification details.`]}),`\n`,_jsxs(_components.li,{children:[`Credits are consumed only for `,_jsx(_components.strong,{children:`valid initiation requests`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Ensure the GSTIN follows the standard `,_jsx(_components.strong,{children:`15-character format`}),` before making the request to avoid unnecessary failures.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Initiate","openapi":"POST /gst/initiate","description":"Initiates a GST verification request.\nThe response returns a `request_id` which should be used to fetch the verification result.\n","href":"/api-reference/business-verification/gst-verification/initiate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":3,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":3,"children":[]},{"title":"Important Notes","slug":"important-notes","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Initiate GST Verification","description":"Initiates a GST verification request.\nThe response returns a `request_id` which should be used to fetch the verification result.\n","operationId":"initiateGstVerification","tags":["Business Verification","GST Verification"],"requestBody":"d0a0a187-54d0-4bca-a492-723fda9e2d8f","responses":{"202":"8b335744-48c5-4735-8509-09d224a61f56","400":"0abec7e4-69d3-4a0e-9175-37b5fdd40b45","401":"871ee1f0-880a-41be-9f02-a4f0d557e5cf","402":"f36f6de6-b5f7-4d51-847b-75cb767b34f5","403":"00c8c537-4515-4db1-b4a3-93f92a1311f9","500":"26af2cfc-a96a-4f9c-890c-186e00ae2bf4"},"method":"post","type":"path","servers":["0f4398fb-151c-4843-bf1d-e8ec85190589","d0880660-8419-4297-855a-15a6f3f6b477"],"security":["7e290d57-06ef-429a-a878-7d3fcc230981"],"path":"/gst/initiate","baseUrlOptions":["https://bgv.konnectnxt.com/api","https://testbgv.konnectnxt.com/api"],"title":"Initiate GST Verification","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gstin"],"properties":{"gstin":{"type":"string","example":"36AAGCN9336F1Z9","description":"Valid 15-character GST Identification Number.","isRequired":true,"uniqueKey":"gstin","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"gstin":"36AAGCN9336F1Z9"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"8b335744-48c5-4735-8509-09d224a61f56":{"description":"GST verification successfully initiated.","content":{"application/json":{"schema":{"type":"object","required":["data","credits_used","credits_left","status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"request_id":{"description":"Unique ID for the GST Verification Request","type":"string","format":"uuid","example":"cbb66de8-83f3-47f9-90f5-4719340d2f39","uniqueKey":"data.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"credits_used":{"type":"integer","description":"Represents the total number of credits used in this request.","example":3,"isRequired":true,"uniqueKey":"credits_used","typeLabel":"integer"},"credits_left":{"type":"integer","description":"Represents the remaining credits available for use. ","example":4040,"isRequired":true,"uniqueKey":"credits_left","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Success":{"title":"Success","description":"Success Response","value":{"status":"success","code":200,"message":"string","data":{"request_id":"cbb66de8-83f3-47f9-90f5-4719340d2f39"},"credits_used":3,"credits_left":34}}},"exampleType":"examples"}},"exampleType":"examples"},"0abec7e4-69d3-4a0e-9175-37b5fdd40b45":{"401":{"$ref":"#/components/responses/401"},"402":{"$ref":"#/components/responses/402"},"403":{"$ref":"#/components/responses/403"},"404":{"description":"No Records Found","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/APIBaseResponse"},{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["case_id"],"properties":{"case_id":{"$ref":"#/components/schemas/CaseId"}}}}},{"$ref":"#/components/schemas/Credits"}]},"examples":{"No records found":{"summary":"No records Found","value":{"status":"error","code":404,"message":"No records found.","data":{"case_id":"8a3b2d79e91c4ff1b2e97b9f2b36c123"},"credits_used":0,"credits_remaining":499}}}}}},"500":{"$ref":"#/components/responses/500_WithCredits","description":"Internal server error."},"description":"Bad request due to invalid input data.","content":{"application/json":{"examples":{"Invalid GST Number":{"title":"Invalid GST Number","value":{"status":"error","code":400,"message":"Invalid GST Number","data":null,"credits_used":0,"credits_remaining":8858}}},"exampleType":"examples"}},"exampleType":"examples"},"871ee1f0-880a-41be-9f02-a4f0d557e5cf":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Missing Token":{"title":"Missing Token","value":{"status":"error","code":401,"message":"Bearer token is missing or invalid.","data":null}},"Incorrect Token Format":{"title":"Incorrect Token Format","value":{"status":"error","code":401,"message":"Token format is incorrect","data":null}},"No Admin Found":{"title":"No Admin Found","value":{"status":"error","code":401,"message":"No admin user found for this organization","data":null}},"Invalid API Key":{"title":"Invalid API Key","value":{"status":"error","code":401,"message":"Invalid API key (organization ID)","data":null}},"User not Found":{"title":"User not Found","value":{"status":"error","code":401,"message":"User not found.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"f36f6de6-b5f7-4d51-847b-75cb767b34f5":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Credit Limit Exceed":{"title":"Credit Limit Exceed","value":{"status":"error","code":402,"message":"Credit Limit Exceeded.","data":null}},"Insufficient Credits":{"title":"Insufficient Credits","value":{"status":"error","code":402,"message":"Insufficient credits: 2 required, 1 remaining.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"00c8c537-4515-4db1-b4a3-93f92a1311f9":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Token Revoked":{"title":"Token Revoked","value":{"status":"error","code":403,"message":"Token access has been Revoked, Contact Support.","data":null}},"Token Inactive":{"title":"Token Inactive","value":{"status":"error","code":403,"message":"Token is Inactive, Contact Support.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"26af2cfc-a96a-4f9c-890c-186e00ae2bf4":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","required":["credits_used","credits_left","status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"credits_used":{"type":"integer","description":"Represents the total number of credits used in this request.","example":3,"isRequired":true,"uniqueKey":"credits_used","typeLabel":"integer"},"credits_left":{"type":"integer","description":"Represents the remaining credits available for use. ","example":4040,"isRequired":true,"uniqueKey":"credits_left","typeLabel":"integer"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Internal Server Error":{"title":"Internal Server Error","value":{"status":"error","code":500,"message":"Internal Server Error.","data":null,"credits_used":3,"credits_remaining":178}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"7e290d57-06ef-429a-a878-7d3fcc230981":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key issued by KonnectNXT. Pass as `Authorization: Bearer \u003cyour_api_key>`.","scopes":[]}}},"servers":{"0f4398fb-151c-4843-bf1d-e8ec85190589":{"url":"https://bgv.konnectnxt.com/api","description":"Production"},"d0880660-8419-4297-855a-15a6f3f6b477":{"url":"https://testbgv.konnectnxt.com/api","description":"QA"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key issued by KonnectNXT. Pass as `Authorization: Bearer \u003cyour_api_key>`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key issued by KonnectNXT. Pass as `Authorization: Bearer \u003cyour_api_key>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"konnectnxt-599b559e","siteName":"KonnectNXT","title":"Initiate - KonnectNXT","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-04T13:40:07.213Z","originalFileLocation":"api-reference/business-verification/gst-verification/initiate.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Initiates a GST verification request. The response returns a request_id which should be used to fetch the verification result.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KonnectNXT\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Initiate - KonnectNXT\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiates a GST verification request. The response returns a request_id which should be used to fetch the verification result.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KonnectNXT\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://konnectnxt-599b559e.mintlify.site/_mintlify/api/og/v2?division=GST+Verification\u0026amp;title=Initiate\u0026amp;description=Initiates+a+GST+verification+request.%0AThe+response+returns+a+%60request_id%60+which+should+be+used+to+fetch+the+verification+result.%0A\u0026amp;theme=7cc3ec472db4b3c9e2a39a5f\u0026amp;signature=d0fa49b924a508f33e3d7fb68db446cf4eab9f7b0414595d5278daf40d4ce937\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Initiate - KonnectNXT\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiates a GST verification request. The response returns a request_id which should be used to fetch the verification result.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://konnectnxt-599b559e.mintlify.site/_mintlify/api/og/v2?division=GST+Verification\u0026amp;title=Initiate\u0026amp;description=Initiates+a+GST+verification+request.%0AThe+response+returns+a+%60request_id%60+which+should+be+used+to+fetch+the+verification+result.%0A\u0026amp;theme=7cc3ec472db4b3c9e2a39a5f\u0026amp;signature=d0fa49b924a508f33e3d7fb68db446cf4eab9f7b0414595d5278daf40d4ce937\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KonnectNXT\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#005eff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/business-verification/gst-verification/initiate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.konnectnxt.com/#organization\",\"name\":\"KonnectNXT\",\"url\":\"https://docs.konnectnxt.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/konnectnxt-599b559e/cyfEQxBdIVhYMC5i/logo/light.png?fit=max\u0026auto=format\u0026n=cyfEQxBdIVhYMC5i\u0026q=85\u0026s=2698d3d46a93990f38aa74081cd25a57\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.konnectnxt.com#website\",\"name\":\"KonnectNXT\",\"url\":\"https://docs.konnectnxt.com\",\"publisher\":{\"@id\":\"https://docs.konnectnxt.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate#webpage\",\"url\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate\",\"name\":\"Initiate\",\"description\":\"Initiates a GST verification request. The response returns a request_id which should be used to fetch the verification result.\",\"dateModified\":\"2026-06-04T13:40:07.213Z\",\"isPartOf\":{\"@id\":\"https://docs.konnectnxt.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Business Verification\",\"item\":\"https://docs.konnectnxt.com/api-reference/business-verification/pan-gst-link\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GST Verification\",\"item\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/certificate\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Initiate\",\"item\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate#apireference\",\"headline\":\"Initiate\",\"name\":\"Initiate\",\"description\":\"Initiates a GST verification request. The response returns a request_id which should be used to fetch the verification result.\",\"url\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.konnectnxt.com/api-reference/business-verification/gst-verification/initiate#webpage\"},\"dateModified\":\"2026-06-04T13:40:07.213Z\",\"publisher\":{\"@id\":\"https://docs.konnectnxt.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.konnectnxt.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"KonnectNXT\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"KonnectNXT\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/business-verification/gst-verification/initiate.md","siteName":"KonnectNXT","nav":{"global":{"anchors":[{"anchor":"Terms \u0026 Conditions","href":"https://konnectnxt.com/terms-and-conditions","icon":{"name":"file","style":"light"}},{"anchor":"Privacy Policy","href":"https://konnectnxt.com/privacy-policy","icon":{"name":"lock","style":"light"}}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/product-docs/getting-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Background Verification","pages":[{"group":"BGV Submit V2","pages":[{"title":"Submit Candidates for BGV (Bulk)","openapi":"POST /async/v2/bgv-submit/","href":"/api-reference/bgv/bgv-submit-v2"},{"title":"Download BGV Report","openapi":"GET /verification/bgv/download","href":"/api-reference/bgv/bgv-report-download"},{"title":"Fetch BGV Report (JSON)","openapi":"GET /recruiter/v2/report-json/","href":"/api-reference/bgv/bgv-report-json"}]},{"group":"DigiLocker","pages":[{"title":"Initiate DigiLocker","openapi":"POST /client/profile-creation-with-digilocker","href":"/api-reference/digilocker/initiate"},{"title":"Fetch DigiLocker Data","openapi":"GET /client/fetch-profile-data","href":"/api-reference/digilocker/retrieve-data"}]},{"group":"Crime Check","pages":[{"title":"Initiate Crime Check","openapi":"POST /v2/verification/crime-check/","href":"/api-reference/bgv/crime-check-initiate"},{"title":"Get Crime Report","openapi":"GET /v2/verification/crime-check/","href":"/api-reference/bgv/crime-check-report"}]},{"group":"Identity Verification","pages":[{"group":"Aadhaar","pages":[{"title":"Aadhaar Basic","openapi":"POST /verification/aadhaar-without-otp","href":"/api-reference/identity-verification/aadhaar/aadhaar-basic"}]},{"group":"PAN","pages":[{"title":"PAN Verification v2","openapi":"POST /v2/verification/pan","href":"/api-reference/identity-verification/pan/pan-verification-v2"},{"title":"Pan Basic","openapi":"POST /verification/pan-basic","href":"/api-reference/identity-verification/pan/pan-basic"},{"title":"PAN-Aadhaar Link","openapi":"POST /v2/verification/pan-aadhaar-link/","href":"/api-reference/identity-verification/pan/pan-aadhaar-link"}]},{"group":"Driving Licence","pages":[{"title":"Driving Licence Verification v2","openapi":"POST /v2/verification/driving-licence","href":"/api-reference/identity-verification/dl/driving-licence-v2"},{"title":"Driving Licence","openapi":"POST /verification/driving-licence","href":"/api-reference/identity-verification/dl/driving-licence"}]},{"group":"Passport","pages":[{"title":"Passport v2","openapi":"POST /v2/verification/passport/","href":"/api-reference/identity-verification/passport/passport-verification-v2"}]}]},{"group":"Employment","pages":[{"title":"Employment History","openapi":"GET /verification/get-employment-history","href":"/api-reference/employment/employment-history"},{"group":"EPFO Verification","pages":[{"title":"EPFO Verification","openapi":"POST /v2/verification/epfo/","href":"/api-reference/employment/epfo-verification"},{"title":"Get Task Status","openapi":"GET /v2/tasks/","href":"/api-reference/employment/task_status"}]}]}]},{"group":"Lookup APIs","pages":[{"title":"Mobile to PAN","openapi":"GET /lookup/mobile-to-pan","href":"/api-reference/lookup/mobile-to-pan"}]},{"group":"Financial APIs","pages":[{"group":"Bank Account","pages":[{"title":"Bank Account v2","openapi":"POST /v2/verification/bank-account/","href":"/api-reference/financial/bank-account/advance-v2"},{"title":"Bank Account (Advance)","sidebarTitle":"Advance","openapi":"POST /verification/bank-verification-advance","href":"/api-reference/financial/bank-account/advance"}]},{"title":"Customer Financial Data Pull","sidebarTitle":"Customer Data Pull","openapi":"POST /v2/finance/customer-data-pull","href":"/api-reference/financial/customer-data-pull"}]},{"group":"Vehicle APIs","pages":[{"group":"Vehicle Details","pages":[{"title":"Vehicle Details","openapi":"POST /v2/verification/rc-book/","href":"/api-reference/vehicle/vehicle-details"}]}]},{"group":"OCR APIs","pages":[{"title":"Aadhaar v2","openapi":"POST /v2/ocr/aadhaar","href":"/api-reference/ocr/aadhaar-ocr"},{"title":"PAN v2","openapi":"POST /v2/ocr/pan","href":"/api-reference/ocr/pan-ocr"},{"title":"Indian Cheque v2","openapi":"POST /v2/ocr/cheque/","href":"/api-reference/ocr/cheque-ocr"},{"title":"GST Certificate v2","openapi":"POST /v2/ocr/gst-certificate/","href":"/api-reference/ocr/gst-certificate"}]},{"group":"Masking APIs","pages":[{"title":"Mask Aadhaar","openapi":"POST /v2/mask/aadhaar","href":"/api-reference/masking/aadhaar-masking"}]},{"group":"Validation","pages":[{"title":"Document Validation","openapi":"POST /v2/validate/document/","href":"/api-reference/validation/document-validation"}]},{"group":"Business Verification","pages":[{"title":"PAN-GST Link","openapi":"POST /v2/verification/pan-gst-link/","href":"/api-reference/business-verification/pan-gst-link"},{"group":"GST Verification","pages":[{"title":"GST Certificate v2","openapi":"POST /v2/verification/gst-certificate/","description":"Verify GST certificate details including registration information, filing history, and e-invoice status without document parsing","href":"/api-reference/business-verification/gst-verification/certificate"},{"title":"Initiate","openapi":"POST /gst/initiate","href":"/api-reference/business-verification/gst-verification/initiate"},{"title":"Status","openapi":"GET /gst/status","description":"Fetches the GST verification result using the `request_id`\nreturned from the initiate API.\n","href":"/api-reference/business-verification/gst-verification/status"}]}]},{"group":"Document E-Sign","pages":[{"group":"E-Sign with Aadhaar","pages":[{"title":"E-Sign Generate API","openapi":"POST /esign/generate/","href":"/api-reference/e-Sign/generate"},{"title":"E-Sign Retrieve API","openapi":"POST /esign/retrieve/","href":"/api-reference/e-Sign/retrieve"}]}]},{"group":"Global DB","pages":[{"group":"Global DB check","pages":[{"title":"Global DB Initiate Check API","openapi":"POST /v2/verification/global-db/initiate/","href":"/api-reference/global-db/initiate"},{"title":"Global DB Result API","openapi":"GET /v2/verification/global-db/result/","href":"/api-reference/global-db/result"}]}]},{"group":"Credits","pages":[{"title":"Transaction Logs","openapi":"GET /v2/credits/transactions","href":"/api-reference/credits/transactions"}]}]}]},"basePath":"","title":"Initiate - KonnectNXT","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}