GET /v1/directors/{din}
Fields returned
din, name, status
linked_companies: cin, company_name, status, designation, appointment_date (up to 10)
linked_companies_total
Sample request and response
Sample request
curl -H "Authorization: Bearer vz_test_…" \
https://api.verizol.ai/v1/directors/<DIN>Sample response
{
"data": {
"din": "01234567",
"name": "A B",
"status": "ACTIVE",
"linked_companies": [
{
"cin": "U12345MH2010PTC123456",
"company_name": "EXAMPLE PRIVATE LIMITED",
"status": "ACTIVE",
"designation": "Director",
"appointment_date": "2010-04-12"
}
],
"linked_companies_total": 1
},
"meta": { "request_id": "4f1c2a9be0d34c51a7e0c1d2b3a4f5e6", "credits_charged": null, "credits_remaining": null, "sandbox": true }
}How it works
- Base URL https://api.verizol.ai/v1. Send your key as Authorization: Bearer <key>.
- Sandbox keys start with vz_test_ and live keys start with vz_live_.
- Each successful call costs its endpoint's price: a lookup costs 1 API credit, a search with a match costs 2. Failed calls and searches with no match are free.
- A plan is not required: API credits alone admit you at 50 calls a minute; a plan with API access sets its own rate.
- Successful responses are wrapped as { data, meta } with a request_id, the credits_charged and your credits_remaining.
- Errors are not wrapped: they follow RFC 9457 (application/problem+json) and carry a stable code and the request_id.
- Contact email and phone in live responses follow your plan, as on the website. Director personal contact details are never returned.
- Sandbox: 10 calls per IP per day, with contact details masked.
Credits and rate limits
| Starter plan | 100 API credits | 30 calls / minute |
|---|---|---|
| Growth plan | 300 API credits | 60 calls / minute |
| Business plan | 500 API credits | 100 calls / minute |
| Enterprise plan | 5,000 API credits | 100 calls / minute |
| No plan | API credit packs or add-ons | 50 calls / minute |
Plan credits expire with the plan. API credit packs and monthly add-ons are on the MCA Data API page; no plan is needed to use them.