Get Job Status
Confirm the job status of the asynchronous API and get Section 206AB & 206CCA Compliance results.
Overview
API takes job_id
and gives back job status
and signed_url
to the compliance check result
Problem
- After posting a job using Section 206AB & 206CCA Compliance Check Async API, businesses will require compliance results
- To process the Compliance results, businesses would prefer the data in a readable format.
Solution
- API that provides the status of your async compliance check.
- Upon successful completion, you will be provided with a
signed_url
to XLSX file with the list of PANs and their compliance check results.
Endpoint
HTTP Method | Resource |
---|---|
GET | /itd/reporting-portal/tds/206-ab |
Request
Follow the below guidelines to pass the Job ID to check the status of your compliance check.
Query Parameters
Param | Type | Description | Example |
---|---|---|---|
job_id | string | Job ID obtained from the previous step. | 1546372e-6fc5-45bb-a2d9-b18d0c662427 |
Sample CURL request
curl --request GET \
--url 'https://api.sandbox.co.in/itd/reporting-portal/tds/206-ab?job_id=1546372e-6fc5-45bb-a2d9-b18d0c662427' \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'x-api-key: xxxxxxxxxxxxxxxxx' \
--header 'x-api-version: 1.0'
Test Environment Available
Response
Param | Type | Description | Example |
---|---|---|---|
job_id | string | The Job ID of the particular JOB. You can check the job status with the Get Job Status | f24cd229-42c8-43de-af79-8ce2d3c4c3db |
status | string | Job Status. Possible Values:JOBQUEUED JOBDONE JOBFAILED | JOBQUEUED |
signed_url | string | Link to where you can find the result of the compliance check performed on the PAN numbers sent in the previous step. Will be provided when the status is JOBDONE | https://.... |
PAN | string | 10-character alphanumeric unique identifier for an income taxpayer | XXXPX1234A |
Name | string | Name of Taxpayer (masked) | HXXXH CXXXXXXXXXXXI BXXXXXA |
PAN Allotment Date | string | PAN allotment date | 1463423400000 |
PAN Status | string | Possible value:Operative , Inoperative | Operative |
Specified Person u/s 206AB & 206CCA | string | Flag for a compliance check. Possible value: Y N Y* If Y , then a higher TDS rate is to be applied for specified persons u/s 206AB & 206CCA.If Y* , then It may be noted that as per the provisos of Section 206AB & 206CCA of the Act, the specified persons shall not include a non-resident who does not have a permanent establishment in India. Tax Deductors & Collectors are expected to carry out necessary due diligence in respect of a specified person established by this functionality to consider him as non-specified if he falls under these provisos | N |
What does the response XLSX file contain?
Compliance Check for Section 206AB and Section 206CCA Async API responds with a signed URL of an Excel file which gives you relevant information to Section 206AB & CCA of PAN provided in the input. Below is an example of the data obtained:
# | PAN | Name | PAN Allotment Date | PAN-Aadhar Link Status | Specified person u/s 206AB & 206CCA |
---|---|---|---|---|---|
1 | DGXXXXXA | YXXH MXXXXI | 12-06-2018 | Linked | Yes |
2 | CLXXXXXW | HXXXH BXXXXXA | 11-12-2009 | Not Linked | No |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Get Job Status API is not a Paid API, no wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to our versioning policies here
Updated about 1 month ago