Registration APIs
Under the GST regime, the taxpayer would not be able to carry out a business transaction without a GST registration. So, it is important for you to take a fresh GST registration in case of cancellation of the old one.
Overview
The GST Registration API allows the taxpayer to register a new GST entity from their GST Portal.
Endpoint
| HTTP Method | Endpoint |
|---|---|
| POST | /gsp/tax-payer/registration |
Important Links
Request
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| rgdtls | string | Registration Details of Payload | |
| rgdtls.aplty | string | Application Type | APLRG |
| rgdtls.aplst | string | Application State | PFV |
| rgdtls.moddt | string | Modification date | 20/01/2017 |
| rgdtls.duedt | string | Due date | 27/01/2017 |
| rgdtls.em | string | [email protected] | |
| rgdtls.mbno | string | Mobile number | 9956332478 |
| bzdtls | string | Business Details | |
| bzdtls.bzdtlsbz | string | Business details of your business | |
| bzdtls.bzdtlsbz.lgnmbzpan | string | Legal name of the business | Rashtriya Ispath Nigam Ltd |
| bzdtls.bzdtlsbz.trdnm | string | Trade name | Vizag Steel |
| bzdtls.bzdtlsbz.cobz | string | Constitution of Business | PRO |
| bzdtls.bzdtlsbz.pan | string | PAN of the proprietor/PAN of the business | |
| bzdtls.bzdtlsbz.pan.num | string | PAN number | AAAAA0000A |
| bzdtls.bzdtlsbz.pan.iv | string | PAN number is validated or Not Validated or In Progress | V |
| bzdtls.bzdtlsbz.stcd | integer | State Code | 29 |
| bzdtls.bzdtlsbz.sj | string | State Jurisdiction | ward1 |
| bzdtls.bzdtlsbz.sj.stjd | string | State Jurisdiction | circle |
| bzdtls.bzdtlsbz.sj.stjdno | string | Ward/Circle/Sector No | KA001 |
| bzdtls.bzdtlsbz.cj | string | Center Jurisdiction | range1 |
| bzdtls.bzdtlsbz.cj.rangecd | string | Range Code | 30501 |
| bzdtls.bzdtlsbz.cj.comrtcd | string | Commisionarate Code | 3 |
| bzdtls.bzdtlsbz.cj.divsncd | string | Division Code | 21 |
| bzdtls.bzdtlsbz.isopcmp | string | Opted in for Composition Possible Values : `Y` or `N` | Y |
| bzdtls.bzdtlsbz.iscmpdecl | string | If opt for Comp is Y then declaration of Composition Possible Values : Y or N | Y |
| bzdtls.bzdtlsbz.antoamt | integer | All-India annual turnover declaration amount | 11 |
| bzdtls.bzdtlsbz.cmbzdt | string | Date of commencement of business | 27/01/2017 |
| bzdtls.bzdtlsbz.iscasdl | string | Are you Casual Dealer | Y |
| bzdtls.bzdtlsbz.otherRsLib | string | Other Reason for liability | liability reason |
| bzdtls.bzdtlsbz.estcgstamt | integer | Estimated Tax Liability (CGST) | 1000000 |
| bzdtls.bzdtlsbz.estsgstamt | integer | Estimated Tax Liability (SGST) | 500000 |
| bzdtls.bzdtlsbz.estigstamt | integer | Estimated Tax Liability (IGST) | 500000 |
| bzdtls.bzdtlsbz.estcessamt | integer | Estimated CESS amount | 500000 |
| bzdtls.bzdtlsbz.sgsttuovamt | integer | SGST turnover amount | 500000 |
| bzdtls.bzdtlsbz.cesstuovamt | integer | CESS turnover amount | 500000 |
| bzdtls.bzdtlsbz.cgsttuovamt | integer | CGST turnover amount | 500000 |
| bzdtls.bzdtlsbz.igsttuovamt | integer | IGST turnover amount | 500000 |
| bzdtls.bzdtlsbz.rgfmdt | string | Start date from which registration is required | 27/01/2017 |
| bzdtls.bzdtlsbz.rgtodt | string | End date for registration period | 27/01/2017 |
| bzdtls.bzdtlsbz.rslibrg | string | Reason of liability to obtain registration | CRTH |
| bzdtls.bzdtlsbz.isthrlmt | string | Have you crossed the threshold limit, to become a taxable person, specified in second provision to section 9(1) | Y |
| bzdtls.bzdtlsbz.librgdt | string | Date on which liability to register arises | 02/10/2016 |
| bzdtls.exrgdtls | string | Existing Registration Details | |
| bzdtls.exrgdtls.dtreg | string | Date of registration | 02/10/2016 |
| bzdtls.exrgdtls.ty | string | Type | cst |
| bzdtls.exrgdtls.id | string | ID | AS4343S |
| bzdtls.exrgdtls.iv | string | is Validated or Not Validated | V |
| bzdtls.dcupdtls | string | Documents Details | |
| bzdtls.dcupdtls.ct | string | Content type | image/jpeg |
| bzdtls.dcupdtls.id | string | Document Id | 123 |
| bzdtls.dcupdtls.ty | string | Document Type | PHOT |
| bzdtls.dcupdtls.hash | string | Document hash | Hash of the document |
| ppbzdtls | string | Details of Principal Place of Business | Y |
| ppbzdtls.hasaddl | string | Has additional details | |
| ppbzdtls.add | string | Address section | C6-89 |
| ppbzdtls.add.bno | string | Building Name | 4th |
| ppbzdtls.add.flno | string | Floor Number | Uniworld |
| ppbzdtls.add.bnm | string | Building Name | Electronic city |
| ppbzdtls.add.st | string | Street | Neeladri |
Test Environment Not Available
Response
The response includes the following Registration details below
| Param | Type | Description | Example |
|---|---|---|---|
| status_cd | string | Status Code | 1 |
| error | string | Error Information | |
| error.error_cd | string | Error Code | REG20142_MSG |
| error.message | string | Error message | Invalid Mobile number |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Registration API is a Paid API, a wallet charge will be applicable, for more information contact support.
Versioning
This API is currently in major version 1.0. Refer to our versioning policies here
Updated 5 months ago