New TDS Return APIs

As part of POST to GET, we have released new TDS Return APIs. While the methods to file TDS returns by providing TXT and CSI files or by submitting a zip file containing the FVU and Form 27A existed in previous contracts, we are enhancing the capabilities and streamlining the process with these new endpoints.

Moreover, with the introduction of the Fetch Jobs API, users can now easily track and retrieve the status of their TDS return jobs submitted through Sandbox APIs.

Using TXT & CSI

You can refer to the new endpoints for TDS Return APIs using TXT and CSI here

Consequently, the previous contracts have been deprecated.

Using FVU & Form 27A

You can refer to the new endpoints for TDS Return APIs using the zip of FVU & Form27A here

Consequently, the previous contracts have been deprecated.

Fetch Jobs API

Users can now utilize this API to Fetch TDS Return Jobs based on the provided tan, quarter, form & financial_year. Additionally, you have the option to retrieve jobs within a specified period for easier search and more flexible filtering.

{
  "code": 200,
  "timestamp": 1715757773000,
  "transaction_id": "109469b2-0748-4135-a569-e86fc9e45756",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.e-file.paginated_list",
    "items": [
      {
        "@entity": "in.co.sandbox.tds.compliance.e-file.job",
        "job_id": "096c4812-1829-4ee1-a3c6-3bd291654b72",
        "tan": "AHMS12345C",
        "financial_year": "FY 2023-24",
        "quarter": "Q2",
        "form": "26Q",
        "created_at": 1714529043000,
        "updated_at": 1714529044000,
        "status": "succeeded",
        "return_receipt_number": 123456789012345
      },
      {
        "@entity": "in.co.sandbox.tds.compliance.e-file.job",
        "job_id": "096c4812-1829-4ee1-a3c6-3bd291654b72",
        "tan": "AHMS12345C",
        "financial_year": "FY 2023-24",
        "quarter": "Q2",
        "form": "26Q",
        "created_at": 1714527043000,
        "updated_at": 1714527044000,
        "status": "failed",
        "message": "Unacceptable FVU"
      },
      {
        "@entity": "in.co.sandbox.tds.compliance.e-file.job",
        "job_id": "096c4812-1829-4ee1-a3c6-3bd291654b72",
        "tan": "AHMS12345C",
        "financial_year": "FY 2023-24",
        "quarter": "Q2",
        "form": "26Q",
        "created_at": 1714530043000,
        "updated_at": 1714530044000,
        "status": "failed",
        "message": "Validation error"
      }
    ],
    "last_evaluated_key": "eydadadadada...=="
  }
}