Simple Search by CIN

API Description

The Simple Search by CIN API is a powerful tool that allows users to retrieve comprehensive information about a company along with detailed insights about each of its directors. By providing the company identification number (CIN) as input, this API delivers an extensive range of company details as well as valuable information about each director, including their identification number, designation, name, date of appointment, current status, DSC (Digital Signature Certificate) expiry date, DSC status, and other relevant data.

This API serves as a reliable and efficient solution for businesses, researchers, and organizations that require a comprehensive understanding of a company's structure and its associated directors. With the ability to access detailed information about each director, including their roles and responsibilities within the company, this API enables users to make informed decisions, conduct due diligence, and gain valuable insights into the corporate landscape.

API details

Endpoint

POST https://api.signzy.app/api/v3/roc/simpleSearchByCin

POST https://api-preproduction.signzy.app/api/v3/roc/simpleSearchByCin

Request body parameters

Parameter	Data Type	Description	Required
cin	String	Corporate Identification Number (CIN) of the organization	Mandatory

{
    "cin": "<CIN>"
}

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 clonedthe Signzy support team to get one created.

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/roc/simpleSearchByCin' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth token>' \
--data '{
    "cin": "<CIN>"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	Result details of the task execution
result.numberOfMembers	String	Number of members (currently empty in the response)
result.subCategory	String	Subcategory of the organization
result.class	String	Class of the organization (e.g., PUBLIC)
result.companyType	String	Type of the company (e.g., INDIAN COMPANY)
result.companyName	String	Name of the company
result.paidUpCapital	String	Amount of paid-up capital
result.authorisedCapital	String	Authorized capital of the company
result.whetherListed	String	Whether the company is listed or not
result.dateOfIncorporation	String	Date of incorporation of the company
result.lastAgmDate	String	Last Annual General Meeting (AGM) date
result.registrationNumber	String	Registration number of the company
result.registeredAddress	String	Registered address of the company
result.activeCompliance	String	Active compliance status (currently empty)
result.suspendedAtStockExchange	String	Status of suspension at the stock exchange
result.balanceSheetDate	String	Balance sheet date of the company
result.category	String	Category of the company (e.g., COMPANY LIMITED BY SHARES)
result.status	String	Current status of the company (e.g., ACTIVE) Possible values: [Active, Amalgamated, Converted to LLP, Dissolved, Dormant under section 455, Not available for efiling, Strike Off, Under Liquidation, Under process of striking off, Dissolved under section 59(8), Dissolved under section 54, Strike Off-AwaitingPublication, Dissolved (Liquidated), Inactive for e-filing, Under CIRP]
result.cin	String	Corporate Identification Number (CIN) of the company
result.rocOffice	String	Registrar of Companies (ROC) office
result.countryOfIncorporation	String	Country of incorporation (e.g., INDIAN)
result.descriptionOfMainDivision	String	Description of the main division (currently empty)
result.addressOtherThanRegisteredOffice	String	Address other than the registered office
result.emailId	String	Email ID of the company
result.emailID	String	Email ID of the company (duplicate entry)
result.splitAddress	Object	Split address details
result.splitAddress.district	Array	District of the address (currently only MUMBAI)
result.splitAddress.state	Array	State details of the address (currently only MAHARASHTRA)
result.splitAddress.city	Array	City of the address (currently only MUMBAI)
result.splitAddress.pincode	String	Pincode of the address (currently only 400001)
result.splitAddress.country	Array	Country details of the address (currently only INDIA)
result.splitAddress.addressLine	String	Concatenated address line
result.natureOfBusiness	String	Nature of the business (currently empty)
result.noOfDirectors	String	Number of directors
result.statusForEfiling	String	Status for e-filing (e.g., ACTIVE)
result.statusUnderCirp	String	Status under Corporate Insolvency Resolution Process (CIRP)
result.pan	String	PAN (Permanent Account Number) of the company

result.directorDetails	Array	Array of director details
result.directorDetails[i]	Object	Details of each director.
result.directorDetails[i].din	String	Director Identification Number (DIN)
result.directorDetails[i].designation	String	Designation of the director Possible Values "CEO" "DIRECTOR" "WHOLE-TIME DIRECTOR" "MANAGING DIRECTOR" "ADDITIONAL DIRECTOR" "CFO" "NOMINEE DIRECTOR" "COMPANY SECRETARY"
result.directorDetails[i].dateOfAppointment	String	Date of appointment of the director
result.directorDetails[i].address	String	Address of the director
result.directorDetails[i].name	String	Name of the director
result.directorDetails[i].whetherDscRegistered	String	Whether Director is DSC (Digital Signature Certificate) registered
result.directorDetails[i].dscExpiryDate	String	Expiry date of DSC (Digital Signature Certificate)
result.directorDetails[i].pan	String	PAN (Permanent Account Number) of the director
result.directorDetails[i].noOfCompanies	String	Number of companies associated with the director
result.directorDetails[i].fatherName	String	Father's name of the director
result.directorDetails[i].dob	String	Date of birth of the director
result.directorDetails[i].splitAddress	Object	Split address details of the director
result.directorDetails[i].splitAddress.district	Array	District of the address (currently only MUMBAI)
result.directorDetails[i].splitAddress.state	Array	State details of the address (currently only MAHARASHTRA)
result.directorDetails[i].splitAddress.city	Array	City of the address (currently only MUMBAI)
result.directorDetails[i].splitAddress.pincode	String	Pincode of the address (currently only 400001)
result.directorDetails[i].splitAddress.country	Array	Country details of the address (currently only INDIA)
result.directorDetails[i].splitAddress.addressLine	String	Concatenated address line

Response body

{
    "error": {
        "name": "error",
        "message": "Upstream Down",
        "status": 409,
        "statusCode": 409
    }
}

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!