Company and LLP Master Data
1 endpoint · Core API
This API serves to validate Company, LLP, FCRN, and Foreign LLP Identification Numbers sanctioned by the Ministry of Corporate Affairs (MCA). It facilitates seamless verification of these crucial identification numbers, ensuring compliance and accuracy in business transactions. By accessing the MCA database, the API confirms the legitimacy of the provided identification numbers, offering assurance to stakeholders, investors, and regulatory bodies.
Benefits
- Regulatory ComplianceEnsures adherence to regulatory requirements by authenticating Company, LLP, FCRN, and Foreign LLP Identification Numbers issued by the MCA.
- Data AccuracyProvides reliable verification, reducing errors in business transactions and ensuring accurate identification.
- Trust BuildingEnhances trust among stakeholders, investors, and regulatory bodies by verifying the legitimacy of company and LLP identification numbers.
- Streamlined ProcessesFacilitates seamless integration into systems and workflows, simplifying verification procedures and enhancing operational efficiency.
What you can do
This API authenticates Company, LLP, FCRN, and Foreign LLP Identification Numbers issued by the Ministry of Corporate Affairs (MCA), ensuring secure validation of entity credentials.
Get Company And LLP Master Data
docs.signcare.io/core/api/company-data/company-and-llp-master-data/#post-api-v1-companyllp
Headers
- X-API-KEYstringrequiredYour secret API key for the environment you are calling (Stage and Live use different keys).
- X-API-APP-IDstringrequiredThe App ID issued together with the key.
- Content-Typestringrequiredapplication/json
Body parameters
application/json- consentstringrequiredRequired. The end user's consent to this verification. Send `Y`.minLength 1default Y
- consent_textstringrequiredRequired. The consent statement shown to the end user. Send the default text from the sample.minLength 1default I hear by declare my consent agreeme…
- request_idstringoptionalOptional. Your own id to correlate this call in your logs. A unique id is generated if you leave it out.nullable
- cinstringrequiredRequired. 21-character Corporate Identification Number (CIN) in uppercase, starting with U or L (for example U12345MH2000PTC123456).length 21pattern ^[UL][0-9]{5}[A-Z]{2}[0-9]{4}[A-Z]{3}[0-…default U72900MH1995PLC095642
- active_compliancebooleanrequiredOptional. Set to true to include active compliance information in the response. Defaults to false when omitted.default true
Sample request body
{
"consent": "Y",
"consent_text": "I hear by declare my consent agreement for fetching my information via SignCare API",
"cin": "U72900MH1995PLC095642",
"active_compliance": true
}
Responses
200OK
- successbooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 200
- messagestringoptionalNo description.nullabledefault XXXXX
- dataobjectoptionalResponse model containing the master data of a company or LLP.
1 field
- resultobjectoptionalNo description.
20 fields
- cinstringoptionalNo description.nullable
- company_NamestringoptionalNo description.nullable
- roC_CodestringoptionalNo description.nullable
- registration_NumberstringoptionalNo description.nullable
- company_CategorystringoptionalNo description.nullable
- company_SubCategorystringoptionalNo description.nullable
- classOfCompanystringoptionalNo description.nullable
- authorisedCapitalstringoptionalNo description.nullable
- paidUpCapitalstringoptionalNo description.nullable
- number_of_MembersstringoptionalNo description.nullable
- dateOfIncorporationstringoptionalNo description.nullable
- registered_AddressstringoptionalNo description.nullable
- alternative_AddressstringoptionalNo description.nullable
- emailIdstringoptionalNo description.nullable
- whetherListedOrNotstringoptionalNo description.nullable
- active_CompliancestringoptionalNo description.nullable
- suspended_at_stock_exchangestringoptionalNo description.nullable
- dateOfLastAGMstringoptionalNo description.nullable
- dateOfBalanceSheetstringoptionalNo description.nullable
- company_StatusstringoptionalNo description.nullable
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- isBillablebooleanoptionalWhether this request was charged: true if it was, false if not. Errors always show false. Flows that finish later (ITR Fetch, SHCIL eStamp, DigiLocker, eSign) show false here, because the charge is made when the result is ready. eSign charges each signer when they complete signing. DigiLocker deducts the credit when the link is created and refunds it automatically if the link expires before the user completes it.
Example
{
"success": false,
"statusCode": 200,
"message": "XXXXX",
"data": {
"result": {
"cin": "string",
"company_Name": "string",
"roC_Code": "string",
"registration_Number": "string",
"company_Category": "string",
"company_SubCategory": "string",
"classOfCompany": "string",
"authorisedCapital": "string",
"paidUpCapital": "string",
"number_of_Members": "string",
"dateOfIncorporation": "string",
"registered_Address": "string",
"alternative_Address": "string",
"emailId": "string",
"whetherListedOrNot": "string",
"active_Compliance": "string",
"suspended_at_stock_exchange": "string",
"dateOfLastAGM": "string",
"dateOfBalanceSheet": "string",
"company_Status": "string"
}
},
"messages": [
"string"
],
"request_id": "string",
"isBillable": false
}
400Bad Request
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 400
Example
{
"data": {},
"messages": [
"string"
],
"request_id": "string",
"success": false,
"message": "XXXXX",
"isBillable": false,
"statusCode": 400
}
401Unauthorized
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 401
Example
{
"data": {},
"messages": [
"string"
],
"request_id": "string",
"success": false,
"message": "XXXXX",
"isBillable": false,
"statusCode": 401
}
500Internal Server Error
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 500
Example
{
"data": {},
"messages": [
"string"
],
"request_id": "string",
"success": false,
"message": "XXXXX",
"isBillable": false,
"statusCode": 500
}
Code samplescurl · Node.js · Python
Stage: uat-ext.signcare.io
curl -X POST 'https://uat-ext.signcare.io/api/v1/CompanyLLP' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'X-API-APP-ID: YOUR_APP_ID' \
-H 'Content-Type: application/json' \
-d '{
"consent": "Y",
"consent_text": "I hear by declare my consent agreement for fetching my information via SignCare API",
"cin": "U72900MH1995PLC095642",
"active_compliance": true
}'