Employement Verification Stack

TDS Quarterly Verification

Introduction
The TDS Quarterly Verification API represents a groundbreaking advancement in employment status verification, offering organizations a sophisticated and highly efficient system. Leveraging the power of TDS Quarterly Data, this API provides unparalleled accuracy and efficiency in verifying an individual's employment status within a company.
Key Features
Comprehensive Reporting: By analyzing TDS Quarterly Data, the API generates comprehensive reports on an individual's employment status. It checks if the employee PAN has filed salaried TDS deductions across all TAN(s) associated with the company for the requested financial year.
Unprecedented Accuracy: The API ensures unparalleled accuracy in employment verification, enabling organizations to make informed decisions regarding an individual's employment status.
Detailed Reports
Quarter-wise TDS Filing Status: The reports generated by the API provide detailed information on the TDS filing status for each employee quarter-wise. This detailed insight is presented in a clear and concise manner, facilitating easy interpretation for organizations.
Benefits
Regulatory Compliance: The API helps organizations ensure compliance with applicable regulations and laws by providing accurate and detailed reports on employment status.
Real-time Reporting: Its ability to generate real-time reports sets it apart from other employment verification methods, enabling organizations to streamline their verification processes efficiently.
Conclusion
In summary, the TDS Quarterly Verification API is a game-changer for the employment verification process, offering organizations the tools they need to verify employment status accurately and efficiently. Its ability to provide detailed reports in real-time ensures compliance with regulations and facilitates informed decision-making.
API description
API Endpoint's
UAT Endpoint
POST https://api-preproduction.signzy.app/api/v3/api/tds-quarterly-verification
POST https://api-preproduction.signzy.app/api/v3/api/tds-quarterly-verification
﻿
Headers
Key
Value
Authorization
access token (returned as id field of login request)
Content-type
application/json
Request Data
JSON
{
    "panNumber": "DFYPK1218G",
    "tanNumber": "PNES50845E",
    "financialYear": "2022-23",
    "cin": "R12345AB6784CDE123456",
    "employerName": "SIGNZY TECHNOLOGIES PRIVATE LIMITED"
}
{
    "panNumber": "DFYPK1218G",
    "tanNumber": "PNES50845E",
    "financialYear": "2022-23",
    "cin": "R12345AB6784CDE123456",
    "employerName": "SIGNZY TECHNOLOGIES PRIVATE LIMITED"
}
﻿
Details of the request properties
Parameter
Type
Description
Required
panNumber
String
PAN Number
Mandatory
tanNumber
String
TAN Number
Mandatory
financialYear
String
Financial Year in the format of YYYY-YY (e.g., 2021-22)
Mandatory
cin
String
cin number of the organisation.
Optional
employerName
String
The name of the employer.
Optional
Response
JSON
{
    "result": {
        "tds": [
            {
                "quarter": "Q2",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            },
            {
                "quarter": "Q3",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            },
            {
                "quarter": "Q4",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            },
            {
                "quarter": "Q1",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            }
        ],
        "pan": "DFYPK1218G",
        "tan": "PNES50845E",
        "returnType": "Salary"
    }
}
{
    "result": {
        "tds": [
            {
                "quarter": "Q2",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            },
            {
                "quarter": "Q3",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            },
            {
                "quarter": "Q4",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            },
            {
                "quarter": "Q1",
                "financialYear": "2022-23",
                "count": "3",
                "remarks": "Quarterly statement filed"
            }
        ],
        "pan": "DFYPK1218G",
        "tan": "PNES50845E",
        "returnType": "Salary"
    }
}
﻿
Details of the request properties
Key
Type
Value
result.tds[0].quarter
String
"Q2"
result.tds[0].financialYear
String
"2022-23"
result.tds[0].count
String
"3"
result.tds[0].remarks
String
"Quarterly statement filed"
result.tds[1].quarter
String
"Q3"
result.tds[1].financialYear
String
"2022-23"
result.tds[1].count
String
"3"
result.tds[1].remarks
String
"Quarterly statement filed"
result.tds[2].quarter
String
"Q4"
result.tds[2].financialYear
String
"2022-23"
result.tds[2].count
String
"3"
result.tds[2].remarks
String
"Quarterly statement filed"
﻿
﻿
﻿
result.pan
String
"DFYPK1218G"
result.tan
String
"PNES50845E"
result.returnType
String
"Salary"
Error Codes
Error Code
Description
200
Success - The request was processed successfully.
400
Bad Request - The request was malformed or invalid.
404
Not Found - The requested resource was not found.
409
Conflict - The request conflicts with the server state.
500
Internal Server Error - An unexpected error occurred.
﻿

Advanced Employment Verification

Mobile To UAN Lookup

Docs powered by Archbee

TABLE OF CONTENTS

Details of the request properties

Response

Details of the request properties

Error Codes

Key	Value
Authorization	access token (returned as id field of login request)
Content-type	application/json

Parameter	Type	Description	Required
panNumber	String	PAN Number	Mandatory
tanNumber	String	TAN Number	Mandatory
financialYear	String	Financial Year in the format of YYYY-YY (e.g., 2021-22)	Mandatory
cin	String	cin number of the organisation.	Optional
employerName	String	The name of the employer.	Optional

Key	Type	Value
result.tds[0].quarter	String	"Q2"
result.tds[0].financialYear	String	"2022-23"
result.tds[0].count	String	"3"
result.tds[0].remarks	String	"Quarterly statement filed"
result.tds[1].quarter	String	"Q3"
result.tds[1].financialYear	String	"2022-23"
result.tds[1].count	String	"3"
result.tds[1].remarks	String	"Quarterly statement filed"
result.tds[2].quarter	String	"Q4"
result.tds[2].financialYear	String	"2022-23"
result.tds[2].count	String	"3"
result.tds[2].remarks	String	"Quarterly statement filed"

result.pan	String	"DFYPK1218G"
result.tan	String	"PNES50845E"
result.returnType	String	"Salary"

Error Code	Description
200	Success - The request was processed successfully.
400	Bad Request - The request was malformed or invalid.
404	Not Found - The requested resource was not found.
409	Conflict - The request conflicts with the server state.
500	Internal Server Error - An unexpected error occurred.