GET /v1/search/companies?name={name} · GET /v1/search/llps?llpin={llpin}
What you get
Name search: companies and LLPs whose names match, names that start with your query first
5 matches by default, up to 10 with limit; no pagination
LLPIN search: the LLP with exactly that LLPIN (hyphen optional)
Each match: value (CIN or LLPIN), label (registered name), type (company or llp)
A search with a match costs 2 API credits; no match returns data: [] and costs nothing
Sample request and response
Sample request
curl -H "Authorization: Bearer vz_test_…" \
"https://api.verizol.ai/v1/search/companies?name=falcon&limit=5"Sample response
{
"data": [
{ "value": "U74920TN2006PTC058852", "label": "FALCON (CHENNAI) SECURITY SERVICES PRIVATE LIMITED", "type": "company" },
{ "value": "U36940CH2012PTC034056", "label": "FALCON 1 GOLF PRIVATE LIMITED", "type": "company" },
{ "value": "AAO-4164", "label": "FALCON ACCESS LLP", "type": "llp" }
],
"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.