Company Consolidated

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
Production environment
POST https://api.signzy.app/api/v3/company-consolidated/get-data-status
POST https://api.signzy.app/api/v3/company-consolidated/get-data-status
﻿
UAT/Testing environment
POST https://api-preproduction.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
JSON
{
    "cin": "<CIN of the company>",
    "llpin": "<LLPIN of the company>",
    "pan": "XXXXX0000X",
    "fetchType": "company or llp"
}
{
    "cin": "<CIN of the company>",
    "llpin": "<LLPIN of the company>",
    "pan": "XXXXX0000X",
    "fetchType": "company or llp"
}
﻿
﻿
Code samples
Curl
Node.js
Python
Go
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"
}'
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.
JSON
//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"
        }
    }
}
//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!

Fetch by CIN or LLPIN or PAN realtime

Fetch by CIN realtime

Docs powered by Archbee

TABLE OF CONTENTS

Request body parameters

Code samples

Response body parameters

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.

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

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.