Get certificate job status
curl --request GET \
--url https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status \
--header 'Authorization: <authorization>' \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-version: <x-api-version>'import requests
url = "https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status"
headers = {
"x-api-version": "<x-api-version>",
"Authorization": "<authorization>",
"x-api-key": "<x-api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-api-version': '<x-api-version>',
Authorization: '<authorization>',
'x-api-key': '<x-api-key>'
}
};
fetch('https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"x-api-key: <x-api-key>",
"x-api-version: <x-api-version>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-version", "<x-api-version>")
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status")
.header("x-api-version", "<x-api-version>")
.header("Authorization", "<authorization>")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-version"] = '<x-api-version>'
request["Authorization"] = '<authorization>'
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"code": 200,
"timestamp": 1788762887353,
"data": {
"created_at": 1788762771957,
"updated_at": 1788762775867,
"@entity": "in.co.sandbox.tds.compliance.certificate.job",
"job_id": "b88f494e-e60c-407c-aca4-09676d1c1f9b",
"tan": "AHMS45586C",
"tax_year": "TY 2026-27",
"quarter": "Q1",
"form": "131",
"message": "Failed to submit the certificate job",
"status": "failed"
},
"transaction_id": "a0a12a28-82bb-4fab-bdb2-2b314c97deba"
}Get TDS certificate job status
Check a certificate jobās status using its job ID. Retrieve PDF ZIP download URLs when the job succeeds, or the failure message if it fails.
GET
/
tds
/
compliance
/
traces
/
deductors
/
forms
/
{certificate_type}
/
status
Get certificate job status
curl --request GET \
--url https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status \
--header 'Authorization: <authorization>' \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-version: <x-api-version>'import requests
url = "https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status"
headers = {
"x-api-version": "<x-api-version>",
"Authorization": "<authorization>",
"x-api-key": "<x-api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-api-version': '<x-api-version>',
Authorization: '<authorization>',
'x-api-key': '<x-api-key>'
}
};
fetch('https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"x-api-key: <x-api-key>",
"x-api-version: <x-api-version>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-version", "<x-api-version>")
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status")
.header("x-api-version", "<x-api-version>")
.header("Authorization", "<authorization>")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-version"] = '<x-api-version>'
request["Authorization"] = '<authorization>'
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"code": 200,
"timestamp": 1788762887353,
"data": {
"created_at": 1788762771957,
"updated_at": 1788762775867,
"@entity": "in.co.sandbox.tds.compliance.certificate.job",
"job_id": "b88f494e-e60c-407c-aca4-09676d1c1f9b",
"tan": "AHMS45586C",
"tax_year": "TY 2026-27",
"quarter": "Q1",
"form": "131",
"message": "Failed to submit the certificate job",
"status": "failed"
},
"transaction_id": "a0a12a28-82bb-4fab-bdb2-2b314c97deba"
}To find an earlier job, use Search certificate jobs.
Headers
API version for the request.
JWT access token. For token-generation steps, refer to the Quickstart Guide.
API key used to identify and authenticate the client.
Path Parameters
Certificate type. Use 130 for salary TDS, 131 for other TDS, or 133 for TCS.
Available options:
130, 131, 133 Query Parameters
Unique identifier returned when the certificate job was created.
Was this page helpful?