ROC Director Search API
Send a DIN and get the director’s details and every company and LLP linked to it. Temporarily paused.
The ROC Director Search API is paused for now: calls are refused before anything runs and are never charged. Ask to be told when it is back.
The documentation opens in the VerifyAll dashboard after sign-in, for accounts with approved API access. New to the API? Start with the developer guide.
Overview
What the ROC Director Search API does
The ROC Director Search API is temporarily paused. While it is paused, calls to it are refused before anything runs, and they are never charged. The endpoint, fields and behaviour below describe how it works when it is back, so you can plan an integration now. Use Request access to ask to be told when it returns.
When it is available, the API takes a person’s 8-digit Director Identification Number (DIN) and returns who they are and where they serve: name, father’s name, date of birth, designation, appointment date and address, whether a digital signature certificate (DSC) is registered and when it expires, a count of companies, and each company and LLP the person is or was a director or designated partner of, with the CIN or LLPIN, start and end dates and whether the role is current.
It works from the person outward, where the Company Directors API works from the company inward. That is useful for spotting a promoter who sits on many boards, a director linked to companies that closed or defaulted, or an undisclosed connection between a supplier and your own staff. In the meantime, the Company Directors API is live: send a company’s CIN and it lists the directors and signatories on record with their DINs.
How it works
- 1
While the API is paused, a call to POST /universal/roc-director-search is refused before anything runs and is not charged. The steps below are how it works when it is back.
- 2
Your server sends the din and a consent object (obtained true and a purpose), because this is a check about a person, with an optional client_ref.
- 3
The request is checked first: a DIN that is not 8 digits, or a missing consent, is refused with 400 invalid_request before anything is charged. A valid DIN is checked against live records and the answer comes back in the same call, usually within about 3 seconds.
- 4
The result is stored in your VerifyAll account with a checkResultId, so you can read it again and find it by your client_ref.
Request and response
ROC director search API endpoints and fields
The main fields; the full reference with every field, error code and a cURL sample is in the dashboard docs.
| Endpoint | What it does |
|---|---|
| POST/universal/roc-director-search | Look up a director and their companies and LLPs by DIN (temporarily paused) |
Request fields
| Field | What it is |
|---|---|
| dinRequired | The Director Identification Number, 8 digits. |
| consentRequired | The person’s consent: obtained (must be true) and purpose (up to 200 characters). |
| client_refOptional | Your own reference, stored with the result (up to 100 characters). |
What the answer returns
| Field | What it is |
|---|---|
| din | The DIN that was looked up. |
| name / father_name / date_of_birth | The director’s name, father’s name and date of birth (YYYY-MM-DD). |
| designation / appointed_on | The director’s designation and appointment date. |
| address | The address on one line (full) and in parts: line1, line2, city, district, state, pincode and country. |
| dsc_registered / dsc_expires_on | Whether a digital signature certificate is registered, and when it expires. |
| company_count | The number of companies on record for the DIN. |
| companies[] / llps[] | Each company and LLP: cin or llpin, name, from (appointed on), to (ceased on, null while current) and is_current. |
Base URL https://api.verifyall.ai. Authenticate with the X-API-Key header (a va_sandbox_ or va_live_ key). Every answer carries data, status_code, success, message and message_code; checks add outcome, checkResultId, charged and charged_amount.
Key features
ROC Director Search API features and capabilities
From one DIN to every board seat
Companies and LLPs come back as separate lists, each with its identifier and dates, current and past roles alike.
Past roles with dates
Ceased appointments stay in the answer with their end date, so you can see where a person served before.
DSC status
Whether the director has a registered digital signature certificate and when it expires, useful before relying on them to sign filings.
Never charged while paused
A call made during the pause is refused before anything runs, so a scheduled job cannot spend from your wallet by mistake.
Use cases
Where businesses use the ROC Director Search API
Promoter and guarantor checks
See every company a loan applicant’s promoter or guarantor directs, before you rely on their standing.
Related-party and conflict reviews
Find links between a supplier’s directors and your employees, or between two counterparties that share a director.
Due diligence on key people
Map the board history of the people behind a target company in an acquisition or investment.
Senior hire screening
Confirm the directorships a candidate for a senior role declares, with the person’s consent.
Industries
Coverage
Directors and designated partners in India with an 8-digit DIN, and the companies and LLPs they are or were linked to. The API is temporarily paused.
Limitations to plan for
- The API is temporarily paused: calls are refused before anything runs and are never charged. No date for its return is given here; ask to be told when it is back.
- While it is paused, the Sandbox key does not return sample data for it either.
- It needs the director’s DIN. If you only know the company, use the Company Directors API with its CIN to find the DINs.
- When it is back, a DIN with no record will answer record_not_found and be charged, because the lookup ran.
Integration
How to integrate the ROC Director Search API
From a business account to your first live call.
Step 1
Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.
Step 2
Request Developer API access under Developers in the dashboard: the APIs you need, your expected monthly volume and your use case. The VerifyAll team reviews it and shares the API Services Agreement.
Step 3
Once the agreement is signed and access is approved, create your Sandbox key and build against sample data. Sandbox calls are never charged.
Step 4
Create your Production key, recharge your wallet and switch the key in your code: the endpoint and fields stay the same.
Get started
Be told when the ROC Director Search API is back
Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.
View API documentation
The full reference for ROC Director Search API (endpoints, fields, errors, cURL) opens in the dashboard once your access is approved.
Open the docs (sign-in)Create a business account
API keys are issued to an approved business account. Sign up, then request access under Developers.
Create account
Pricing
Production calls are charged per check from your prepaid VerifyAll wallet, at your account’s API price; GST is added separately when you recharge. Sandbox calls are never charged. Your API prices are shown in the dashboard once access is approved. How pricing works
Already have a business account? Sign in to request access
ROC Director Search API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
Company Directors API
LiveInstant answerSend a CIN and get every director and authorised signatory of the company, with DIN, designation and appointment date.
View API detailsCIN Verification API
LiveInstant answerSend a Corporate Identification Number and get the company’s name, status, capital, address and compliance dates back in one call.
View API detailsPAN to CIN API
LiveInstant answerTurn a company’s or LLP’s PAN into its CIN, and get the company’s details in the same answer.
View API detailsAML Screening API
LiveInstant answerScreen a person or an entity against sanctions, enforcement and regulatory watch lists and adverse media in one call, with every hit scored.
View API details
All business verification (KYB) APIsRun ROC director search in the dashboard, without codeBrowse the API Marketplace
Start with the ROC Director Search API
Request access, build against the Sandbox, then go live with your Production key.