URL Based API
To make some of the GST Public APIs and GSP APIs more easy to consume for Developers, we have provided few of GET APIs through simple GET URL.
Below is the details for integrating GSP APIs and Search GST TaxPayer API with TaxPro GSP through URL based API. Other GST API are TaxPayer specific and requires end-to-end TaxPayer authorized and encrypted session to GSTN servers and hence its not possible to provide those API in this simple form.
Steps:
2. Invoke below URL (API) to GET the required data by passing ASPID, ASP Password along with GSTIN.
1. Search GST TaxPayer Public API:
https://gstapi.charteredinfo.com/commonapi/v1.1/search?Action=TP&Gstin=GSTINOfTaxPayerToSearch
Header Parameter: aspid=ASPID, password : {ASPAcPassword}
2. GST Return Status Pulbic API:
https://gstapi.charteredinfo.com/commonapi/v1.0/returns?Action=RETTRACK&Gstin=GSTINOfTaxPayerToSearch&FY=2018-2019
Header Parameter: aspid=ASPID, password : {ASPAcPassword}
3. Get API Balance:
https://gstapi.charteredinfo.com/aspapi/v1.1/getapibalance
Header Parameter: aspid=ASPID, password : {ASPAcPassword}
4. Get API Settings:
https://gstapi.charteredinfo.com/aspapi/v1.0/getapisetting
Header Parameter: aspid=ASPID
5. Daily API Transaction Log:
https://gstapi.charteredinfo.com/aspapi/v1.0/dailytxnlog?TxnDt=DateOfLogsToBeDownloaded
Header Parameter: aspid=ASPID, password : {ASPAcPassword}
Provide value of url query paramater and header parameter in above urls - marked as BOLD.
Parameters & Values
1. aspid=ASPID (Registered ASPID Received from TaxPro GSP) [Pass only in Header]
2. password=ASPAcPassword (given by you at the time of Registration) [Pass only in Header]
3. Gstin=GSTINOfTaxPayerToSearch – GSTIN to be searched
4. TxnDt=DateOfLogsToBeDownloaded – format DDMMMYY (01Jan17)
Response to the Search GST TaxPayer API Call will be as below
|
Search TaxPayer
|
|
Details
|
Respective Key (Item)
|
Response Sample
|
|
Registration Date
|
rgdt:
|
01/07/2017
|
|
Company Type
|
ctb:
|
Private Limited Company/ Limited Company..
|
|
Constitution of Business
|
sts:
|
Active/ Inactive
|
|
Legal Name
|
lgnm:
|
ABC Corporation LTD.
|
|
State Jurisdiction
|
stj:
|
Jalandhar
|
|
GSTIN
|
gstin:
|
11AAAAA2222Q1Z2
|
|
Nature of Business Activity
|
nba:
|
Recipient of Goods or Services/Wholesale Business
|
