Download Annual Information Statement
Download the complete Annual Information Statement (AIS) file for a registered PAN. Covers all reported financial transactions.
curl -X POST "https://production.deepvue.tech/v1/verification/itr/ais-download" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"itr_client_id": "example_string"
}'
import requests
import json
url = "https://production.deepvue.tech/v1/verification/itr/ais-download"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
data = {
"itr_client_id": "example_string"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/itr/ais-download", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
},
body: JSON.stringify({
"itr_client_id": "example_string"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"itr_client_id": "example_string"
}`)
req, err := http.NewRequest("POST", "https://production.deepvue.tech/v1/verification/itr/ais-download", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/itr/ais-download')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = '{
"itr_client_id": "example_string"
}'
response = http.request(request)
puts response.body
{
"code": 200,
"timestamp": 1771592226614,
"transaction_id": "808f86a8-d792-ca72-8823-99c5c27dd6ad",
"sub_code": "SUCCESS",
"message": "AIS details downloaded successfully.",
"data": {
"itr_client_id": "itr_qkgtvIwLcuooWhtrFFbK",
"pan_no": "EGDPK2567K",
"ais_file": "https://aadhaar-kyc-docs.s3.amazonaws.com/itr/...",
"file_type": "json",
"status": "completed",
"financial_year": "2020-21"
}
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"code": 422,
"timestamp": null,
"transaction_id": "string",
"sub_code": "DOWNLOAD_FAILED",
"message": "Unable to download AIS file."
}
{
"code": 500,
"timestamp": null,
"transaction_id": "string",
"sub_code": "SOURCE_FAILURE",
"message": "Source failure. Unable to process the request."
}
/v1/verification/itr/ais-download
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
The media type of the request body
The unique identifier of the client for whom the Income Tax Return (ITR) is being downloaded.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Body
The unique identifier of the client for whom the Income Tax Return (ITR) is being downloaded.
Responses
Overview
This API downloads the Annual Information Statement (AIS) details as a JSON file. The service delivers a secure, temporary URL to access the full financial data for the specified financial year, making it useful for storing or processing the AIS data offline.
The API requires the itr_client_id parameter, which serves as the unique identifier of the client for whom the AIS is being downloaded. On success, the response includes transaction tracking, the PAN number, a downloadable file URL, file type (JSON), completion status, and the associated financial year.
You need an authorized access token to access any of the Platform APIs. One access token is valid for only 24 hours. After expiration, you can renew the token by using the Authorize endpoint to receive a fresh access token.
Last updated 4 weeks ago
Built with Documentation.AI