Get Data Status (CIN or LLPIN or PAN)

Introduction

This API is designed to provide data status details for both companies and Limited Liability Partnerships (LLPs) by accepting a Corporate Identification Number (CIN), a Limited Liability Partnership Identification Number (LLPIN), or a Permanent Account Number (PAN) as input. Upon submission, users are presented with crucial information including the e-filing status, the date of the most recent update to the entity's details in the Signzy database, the last financial year-end date, and the last filing date. This comprehensive tool ensures that stakeholders have access to the latest compliance and financial filing statuses of companies and LLPs, offering a holistic view of their legal and financial health.

API details

Endpoint

POST https://api.signzy.app/api/v3/company-consolidated/get-data-status

POST https://api-preproduction.signzy.app/api/v3/company-consolidated/get-data-status

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
cin	String	Corporate Identification Number. If both CIN and PAN are provided in the request, fetch will be performed using the CIN number.	Conditionally Mandatory
llpin	String	LLPIN number of the company. If both LLPIN and PAN are provided in the request, get Data Status will be performed using the LLPIN number.	Conditionally Mandatory
pan	String	PAN number of the Company.	Conditionally Mandatory
fetchType	String	fetchType can either be "company" or "llp". Default value is "company"	Conditionally Mandatory

{
    "cin": "<CIN of the company>",
    "llpin": "<LLPIN of the company>",
    "pan": "XXXXX0000X",
    "fetchType": "company or llp"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/company-consolidated/get-data-status' \
--header 'Authorization: <Your Access Token>' \
--header 'Content-Type: application/json' \
--data '{
    "cin": "<CIN of the company>",
    "llpin": "<LLPIN of the company>",
    "pan": "XXXXX0000X",
    "fetchType": "company or llp"
}'

Response body parameters

Response using Corporate Identification Number(CIN)

Parameter	Data Type	Description
result	Object	Contains the results of the request.
result.dataStatus	Object	Contains the data status.
result.dataStatus.eFilingStatus	String	E-Filing status.
result.dataStatus.nextCin	String	Next CIN of the company.
result.dataStatus.lastBaseUpdated	String	Last Base update date.In format DD/MM/YYYY.
result.dataStatus.lastDetailsUpdated	String	Last details update data. In format DD/MM/YYYY.
result.dataStatus.lastFinYearEnd	String	Last financial year end date. In format DD/MM/YYYY.
result.dataStatus.lastFilingDate	String	Last filing date. In format DD/MM/YYYY.

Response using Limited Liability Partnership Identification Number(LLPIN)

Parameter	Data Type	Description
result	Object	Contains the results of the request.
result.dataStatus	Object	Contains status details.
result.dataStatus.eFilingStatus	String	Indicates the current e-filing status.
result.dataStatus.lastBaseUpdated	String	Date when the base information was last updated.
result.dataStatus.lastDetailsUpdated	String	Date when the detailed information was last updated.
result.dataStatus.lastFinYearEnd	String	Date marking the end of the last financial year.
result.dataStatus.lastFinancialReportingDate	String	Date of the last financial reporting.

//CIN Response
{
    "result": {
        "dataStatus": {
            "eFilingStatus": "ACTIVE",
            "nextCin": "",
            "lastBaseUpdated": "31/10/2023",
            "lastDetailsUpdated": "03/11/2023",
            "lastFinYearEnd": "31/03/2022",
            "lastFilingDate": "31/03/2023"
        }
    }
}

//LLPIN Response
{
    "result": {
        "dataStatus": {
            "eFilingStatus": "ACTIVE",
            "lastBaseUpdated": "04/12/2023",
            "lastDetailsUpdated": "14/12/2023",
            "lastFinYearEnd": "31/03/2023",
            "lastFinancialReportingDate": "31/03/2022"
        }
    }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!