GET /v1/companies/{cin}
Fields returned
cin, company_name, registration_no, status
incorporation_date, category, sub_category, class
roc, listed, activity
authorized_capital, paid_up_capital
state, district, pincode
contact: address, email, phone, website
directors: din, name, designation, appointment_date (up to 50)
last_updated
Sample request and response
Sample request
curl -H "Authorization: Bearer vz_test_…" \
https://api.verizol.ai/v1/companies/<CIN>Sample response
{
"data": {
"cin": "U12345MH2010PTC123456",
"company_name": "EXAMPLE PRIVATE LIMITED",
"registration_no": "123456",
"status": "ACTIVE",
"incorporation_date": "2010-04-12",
"category": "Company limited by Shares",
"sub_category": "Non-govt company",
"class": "Private",
"roc": "RoC-Mumbai",
"authorized_capital": 1000000,
"paid_up_capital": 500000,
"listed": false,
"activity": "Business services",
"state": "Maharashtra",
"district": "Mumbai",
"pincode": "400001",
"contact": {
"address": "1 Example Road, Mumbai",
"email": "in*****@example.com",
"phone": "+91 9XXXX XX10",
"website": null
},
"directors": [
{
"din": "01234567",
"name": "A B",
"designation": "Director",
"appointment_date": "2010-04-12"
}
],
"last_updated": "2026-01-15T09:30:00Z"
},
"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.