Company Directors Contact API
SINGLE API TO FETCH CONTACT INFORMATION INCLUDING EMAIL AND MOBILE NUMBER OF ALL THE DIRECTORS AND SIGNATORIES ASSOCIATED TO GIVEN CIN/LLPIN
Powered by Attestr. Visit product page for details.
Description
The Company Directors Contact API provides a simple yet powerful way to instantly access verified contact information of company directors and signatories of any company registered in India. With just a single API request, you can fetch email addresses and mobile numbers of all directors and signatories linked to a given CIN (Corporate Identification Number) or LLPIN (Limited Liability Partnership Identification Number). Designed for businesses, compliance teams, financial institutions, and B2B lead generation, this API eliminates manual lookup, accelerates KYC and onboarding processes, and ensures seamless integration into your existing systems.
API Details
Request
| Type | URL | Current Version |
|---|---|---|
| POST | https://api.attestr.com/api/{version}/public/leadx/mca-cin-contact | v2 |
Request Body Parameters
| Key | Type | Description | Optional (default) | Min Version | Max Version |
|---|---|---|---|---|---|
| reg | String | Input CIN/LLPIN | Required | v2 |
Sample Request Body
{ "reg": "U74999TG2017PTC118280"}Request Header Parameters
| Type | Name | Value / Description | Optional | Min Version | Max Version |
|---|---|---|---|---|---|
| String | Content-Type | application/json | Required | v2 | |
| String | Authorization | Basic {authToken} | Required | v2 |
If you do not have the authentication token, please refer to Register App to generate one.
Response
HTTP Status 200
| Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
| valid | Boolean flag indicating if the provided DIN is valid | Boolean | v2 | |
| indexId | Provided CIN/LLPIN input is returned in the response | String | v2 | |
| businessName | Legal entity. name as registered on MCA | String | v2 | |
| contacts | List of contacts of directors and signatories linked to the provided company. See definition of the object below. | Array <ContactInfo> | v2 |
ContactInfo Object
| Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
| indexId | DIN number of the director | |||
| fullName | Full name of the director | |||
| mobileNumber | mobile number of the director | |||
| emailAddress | email address of the director | |||
| addresses | Addresses as registered |
Sample Response
Sample for successful contact fetch
{ "valid": true, "indexId": "U74999TG2099PTC000000", "businessName": "Acme Corp Private Limited", "contacts": [{ "indexId": "01234567", "fullName": "GITANJALI RAHEJA", "mobileNumber": "+911234567890", "emailAddress": "gitanjali.raheja@acme.com", "addresses": [ { "line1": "3-1-764/1 Pathola Gate, Kachiguda, Kachiguda, Himayathnagar,", "line2": null, "line3": null, "line4": null, "locality": null, "district": null, "city": null, "state": "Telangana", "country": "India", "zip": "500027", "fullAddress": "3-1-764/1 Pathola Gate, Kachiguda, Kachiguda, Himayathnagar,, Telangana, India, 500027" } ]}, { "indexId": "01234568", "fullName": "RAMESH RAHEJA", "mobileNumber": "+911256767890", "emailAddress": "ramesh.raheja@acme.com", "addresses": [ { "line1": "House no 123/4, Awas Vikas Lane, Hanspuram", "line2": "Naubasta", "line3": null, "line4": null, "locality": null, "district": null, "city": "Kanpur", "state": "Uttar Pradesh", "country": "India", "zip": "200019", "fullAddress": "House no 123/4, Awas Vikas Lane, Hanspuram, Naubasta, Kanpur, Uttar Pradesh, India, 200019" } ]} ]}Sample response for the case when data is not available with Attestr
{ "valid": false, "message": "Data not available"}Sample response for invalid non-existent DIN
Error Response
| Parameter | Type | Description |
|---|---|---|
| code | Number | Unique error codes for different errors. Always available. |
| message | String | Error message describing the error. Always Available. |
| details | String | Detail error message. Available only for certain types of errors. |
Error Codes
| HTTP Status | Error Code | Error Message |
|---|---|---|
| 400 | 4001 | Malformed data or missing required parameter values |
| 400 | 4005 | Operation could not be performed due to low credits balance |
| 401 | 4016 | Invalid client authorization |
| 403 | 4031 | Unauthorized access |
| 403 | 4035 | Requested service is not provisioned for your account |
| 403 | 4039 | Client's IP address is not whitelisted |
| 403 | 4035 | Requested service is not provisioned for your account |
| 429 | 4291 | Maximum account rate limit exceeded |
| 429 | 4292 | Maximum API rate limit exceeded |
| 429 | 4293 | Maximum account daily limit exceeded |
| 429 | 4294 | Maximum API daily limit exceeded |
| 500 | 5001 | Request could not be processed |
Sample Error Response
{ "code": 4001, "message": "Malformed data or missing required parameter values"}