Data dictionary
Every field in the API responses, its source and meaning.
All responses are wrapped as { "data": ..., "meta": ... }. Field names are snake_case. Dates are
YYYY-MM-DD; timestamps are ISO 8601 date-times. Every field is always present in the response.
Fields marked always set never contain null; all others are null when the registry has no
value. Arrays are empty rather than null.
Company (GET /v1/companies/{cin})
| Field | Type | Meaning |
|---|---|---|
cin | string | Corporate Identification Number, 21 characters. Always set. |
company_name | string | Registered name. Always set. |
registration_no | string | The last 6 characters of the CIN. Always set. |
status | string | Normalised company status: ACTIVE, INACTIVE, DISSOLVED, STRUCK_OFF, SUSPENDED or UNDER_LIQUIDATION. Always set. |
incorporation_date | date | Date of incorporation. |
category | string | Company category, e.g. "Company limited by Shares". |
sub_category | string | Company sub-category, e.g. "Non-govt company". |
class | string | Class of company, e.g. "Private" or "Public". |
roc | string | Registrar of Companies office. |
authorized_capital | integer | Authorised share capital. |
paid_up_capital | integer | Paid-up share capital. |
listed | boolean | Whether the company is listed on a stock exchange. |
activity | string | Main business activity: the registry's main division description, else its business activity text, else its principal business. |
state | string | State of the registered office. |
district | string | District of the registered office, resolved from Verizol's geographic data. |
pincode | string | Postal code of the registered office. |
contact | object | The company's contact block; its four fields follow. Always set (the object is present even when every field inside it is null). |
contact.address | string | Registered address line and city. |
contact.email | string | Company email. Live keys: returned when your plan includes it, otherwise null. Sandbox: masked. |
contact.phone | string | Company phone. Live keys: needs a plan that includes phone numbers. Sandbox: masked. |
contact.website | string | Company website. |
directors | array | Up to 50 directors, ordered by appointment date. Items below. Always set. |
last_updated | timestamp | When Verizol last updated this company record. |
Director item (inside a company)
| Field | Type | Meaning |
|---|---|---|
din | string | Director Identification Number, 8 digits. Always set. |
name | string | Director's name. Always set. |
designation | string | Designation at this company, falling back to the director's general designation. |
appointment_date | date | Date joined this company, falling back to the director's appointment date. |
Director (GET /v1/directors/{din})
| Field | Type | Meaning |
|---|---|---|
din | string | Director Identification Number. Always set. |
name | string | Director's name. Always set. |
status | string | Normalised status: ACTIVE, RESIGNED, REMOVED or DISQUALIFIED. |
linked_companies | array | Up to 10 companies the director is linked to. Items below. Always set. |
linked_companies_total | integer | The full count of linked companies, which may exceed 10. Always set. |
Director personal contact details are never returned.
Linked company
| Field | Type | Meaning |
|---|---|---|
cin | string | The company's CIN. Always set. |
company_name | string | The company's name. Always set. |
status | string | The company's normalised status (values as above). Always set. |
designation | string | The director's designation at that company. |
appointment_date | date | When the director joined that company. |
LLP (GET /v1/llps/{llpin})
| Field | Type | Meaning |
|---|---|---|
llpin | string | LLP Identification Number, e.g. AAO-4164. Always set. |
llp_name | string | Registered name. Always set. |
status | string | Normalised LLP status: ACTIVE, INACTIVE, DISSOLVED or SUSPENDED. Always set. |
incorporation_date | date | Date of incorporation. |
state | string | State of the registered office. |
district | string | District of the registered office, resolved from Verizol's geographic data. |
pincode | string | Postal code of the registered office. |
address | string | Registered address line and city. |
activity | string | Main business activity: the registry's main division description, else its business activity text. |
contribution | integer | Total obligation of contribution. |
partners | array | Up to 50 partners, most recently joined first. Items below. Always set. |
partners_total | integer | The full count of partners, which may exceed 50. Always set. |
last_updated | timestamp | When Verizol last updated this LLP record. |
Partner
| Field | Type | Meaning |
|---|---|---|
din | string | The partner's DIN or DPIN, when on record. |
name | string | Partner's name. Always set. |
status | string | ACTIVE, INACTIVE or RETIRED. Always set. |
joined_on | date | Date the partner joined the LLP. |
left_on | date | Date the partner left the LLP. |
Partner personal contact details are never returned.
Search match (GET /v1/search/companies, GET /v1/search/llps)
data is an array of matches, best first, and is empty ([]) when nothing matched. A name search
returns 5 matches by default and at most 10 (limit); there is no pagination. An LLPIN search returns
at most one match.
| Field | Type | Meaning |
|---|---|---|
value | string | The match's CIN (for a company) or LLPIN (for an LLP). Always set. |
label | string | The registered name. Always set. |
type | string | company or llp: call GET /v1/companies/{value} or GET /v1/llps/{value} next. Always set. |
Meta
| Field | Type | Meaning |
|---|---|---|
request_id | string | Unique request ID, same as X-Request-Id. Always set. |
credits_remaining | integer | API credits left after this call. null for the sandbox. |
sandbox | boolean | true when the sandbox key was used. Always set. |