Skip to main content
VerifyAll logo
LiveInstant answerSandbox

Company Directors API

Send a CIN and get every director and authorised signatory of the company, with DIN, designation and appointment date.

Request API access Book a demo View API documentation

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 Company Directors API does

The Company Directors API, also known as MCA signatories, takes a company’s CIN and lists the directors and other signatories on record: each person’s name, their Director Identification Number (DIN), their designation (Director, Whole-time Director, Company Secretary and so on), the date they were appointed and their address.

Knowing who runs a company is part of every KYB review. The list tells you who may sign for the business, whether the person in front of you is really a director, and who to screen for sanctions, adverse media or court cases. Where a signatory is identified by PAN instead of a DIN, the PAN comes back masked.

Lenders use it to confirm guarantors and authorised signatories, compliance teams to identify the people to screen, and procurement teams to check that a contract is signed by someone who can sign it. It takes the same CIN as the CIN Verification API, so the two are often called together.

How it works

  1. 1

    Your server sends POST /universal/mca-signatories with the cin and, if you like, a client_ref. A check about a company takes no consent object.

  2. 2

    The request is checked first: a CIN that does not match the 21-character format is refused with 400 invalid_request, before anything runs or is charged.

  3. 3

    The CIN is checked against live records and the signatory list comes back in the same call, usually within about 3 seconds.

  4. 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

Company directors API endpoints and fields

The main fields; the full reference with every field, error code and a cURL sample is in the dashboard docs.

Endpoints
EndpointWhat it does
POST/universal/mca-signatoriesList the directors and signatories of a company by CIN

Request fields

Company Directors API request fields
FieldWhat it is
cinRequiredThe company’s Corporate Identification Number, 21 characters.
client_refOptionalYour own reference, stored with the result (up to 100 characters).

What the answer returns

Company Directors API answer fields
FieldWhat it is
cinThe CIN that was checked.
totalThe number of signatories returned.
signatories[].nameThe director’s or signatory’s name.
signatories[].dinThe 8-digit Director Identification Number, for a director or designated partner.
signatories[].panThe PAN, masked, when the signatory is identified by PAN instead of a DIN.
signatories[].designationFor example Director, Whole-time Director, Company Secretary.
signatories[].appointed_onDate of appointment, YYYY-MM-DD.
signatories[].addressThe signatory’s address in parts and on one line, where on record.

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

Company Directors API features and capabilities

  • Directors and other signatories

    Not only directors: company secretaries and other signatories on record are listed with their designation.

  • DIN for every director

    Each director’s DIN comes back, a stable key for matching the same person across companies in your own records.

  • Appointment dates

    See how long each person has held their role, and spot a board that changed just before an application.

  • Pairs with company verification

    Same CIN in, so a KYB flow can call CIN verification and company directors side by side.

Use cases

Where businesses use the Company Directors API

  • Authorised signatory checks

    Confirm that the person signing a loan agreement, mandate or contract is a director of the company.

  • Screening the people behind a business

    Feed each director’s name into AML screening and court records checks as part of KYB.

  • Guarantor verification

    Check that a director offered as a personal guarantor holds the role they claim.

  • Conflict-of-interest reviews

    Compare a supplier’s directors with your employees and existing vendors.

Industries

Coverage

Companies incorporated in India with a 21-character CIN. The list covers the directors and signatories on record at the time of the call.

Limitations to plan for

  • The list shows who holds a role now. It does not give the history of past directors.
  • A signatory identified by PAN has the PAN masked; a full PAN is never returned.
  • Fields the record does not hold, such as an address, come back as null.
  • A CIN with no record answers record_not_found. The lookup ran, so it is charged.

Integration

How to integrate the Company Directors API

From a business account to your first live call.

  1. Step 1

    Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.

  2. 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.

  3. 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.

  4. 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

Request access to the Company Directors API

Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.

Tell us about your integration

Tell us what you want to verify and how many checks you expect. Our team replies within one business day with access steps, Sandbox details and your API pricing.

We use these details only to reply to your request. See our privacy policy.

  • Contact sales

    Questions on volumes, onboarding or the API agreement.

    Contact sales

  • View API documentation

    The full reference for Company Directors 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

Company Directors API: frequently asked questions

Answers for teams planning an integration.

Still have questions? Our team is happy to help.

Contact Support

All business verification (KYB) APIsRun Company directors in the dashboard, without codeBrowse the API Marketplace

Start with the Company Directors API

Request access, build against the Sandbox, then go live with your Production key.

Request API access