Director DIN To Mobile Number Lookup API
API FOR FETCHING DIRECTOR CONTACT DETAILS FOR A GIVEN DIN NUMBER AS REGISTERED WITH MCA
Description
Attestr's DIN Mobile Number Lookup API is designed for lead generation, enabling you to easily retrieve contact information for company directors using their Director Identification Number (DIN). By providing a DIN, you can access valuable details such as mobile numbers and email addresses to effectively reach out to decision-makers. Ideal for targeted marketing and business outreach, the API offers fast, accurate, and secure data, helping you streamline your lead generation efforts and improve your outreach strategy.
API Details
Request
| Type | URL | Current Version |
|---|---|---|
| POST | https://api.attestr.com/api/{version}/public/leadx/mca-din-contact | v2 |
Request Body Parameters
| Key | Type | Description | Optional (default) | Min Version | Max Version |
|---|---|---|---|---|---|
| reg | String | Input DIN Number | Required | v2 |
Sample Request Body
{ "reg": "07864946"}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 | |
| fullName | Full name of the director | String | v2 | |
| mobileNumber | Mobile number of the director as registered with MCA. It may or may not contain the country code. | String | v2 | |
| emailAddress | Director's email as registered | String | v2 | |
| addresses | List of addresses registered for the director | Array<AddressObject> | v2 |
Sample Response
Sample for successful contact fetch
{ "valid": true, "fullName": "GITANJALI RAHEJA", "mobileNumber": "+9199123456789", "emailAddress": "gitanjali.raheja@attestr.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" } ]}Sample response for the case when data is not available with Attestr
{ "valid": false, "message": "Data not processed"}Sample response for invalid non-existent DIN
{ "valid": false, "message": "Provided director registration number does not exist"}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"}