Early accessWe're onboarding teams in batches. The sandbox and docs are open to everyone. Request access →

Skip to content
APIserver.in

Company Search

Find the right CIN from a name a human typed.

POST/v1/mca/search

₹3.50

per successful call · incl. GST · failed calls ₹0

What it does

Fuzzy search across company and LLP names. Returns ranked matches with CIN/LLPIN, status, state and incorporation year.

Input
Company name
Output
Matching companies with CIN

Use cases

  • Signup forms without a CIN
  • Deduplicating vendor masters
  • Typeahead pickers

Request

curl https://api.apiserver.in/v1/mca/search \
  -H "Authorization: Bearer as_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sabarmati","limit":5}'
const res = await fetch("https://api.apiserver.in/v1/mca/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.APISERVER_KEY ?? "as_test_YOUR_KEY"}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Sabarmati",
    "limit": 5
  }),
});

const { success, data, meta, error } = await res.json();
console.log(meta.charged, meta.amount_inr); // failed calls are never charged
import os, requests

res = requests.post(
    "https://api.apiserver.in/v1/mca/search",
    headers={
        "Authorization": f"Bearer {os.getenv('APISERVER_KEY', 'as_test_YOUR_KEY')}",
    },
    json={
        "name": "Sabarmati",
        "limit": 5,
    },
    timeout=10,
)
body = res.json()
print(body["meta"]["charged"], body["meta"]["amount_inr"])
<?php
$ch = curl_init('https://api.apiserver.in/v1/mca/search');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . (getenv('APISERVER_KEY') ?: 'as_test_YOUR_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name' => 'Sabarmati',
        'limit' => 5,
    ]),
]);
$body = json_decode(curl_exec($ch), true);
echo $body['meta']['charged'] ? 'charged' : 'not charged';
Request body fields
FieldTypeDescription
namerequiredstringCompany or LLP name (fuzzy).
limitintegerMax results (1–20, default 5).

Response

Sample response for a fictional sandbox entity. Click any key to copy its JSON path.

{  : true,  : "as_req_01J9X2K7R8M4V6T2Q9W3E5Y1ZB",  : "mca.search",  : "2026-10-01",  : {    : "Sabarmati",    : 1,    : [      {        : "SABARMATI LOGISTICS PRIVATE LIMITED",        : "U63030GJ2019PTC108745",        : null,        : "Active",        : "Gujarat",        : "2019-01-14",        : 0.81      }    ]  },  : {    : true,    : 3.5,    : 402,    : "live",    : 1,    : "2026-10-03T09:12:00+05:30",    : "live"  }}

Field dictionary — data

Response data fields
FieldTypeDescription
querystring—
countinteger—
resultsobject[]—
↳namestring—
↳cinstring | null—
↳llpinstring | null—
↳statusstring—
↳statestring—
↳incorporated_onstring—
↳scorenumber0–1 relevance score

Errors

Every error uses the same envelope and is billed ₹0 — `meta.charged` is always false.

Errors this endpoint can return
HTTPCodeWhat it meansRetryBilled
400VALIDATION_FAILEDSomething in the request isn't in the right shape — usually an ID with a typo or a missing field.no₹0
401AUTH_INVALID_KEYWe couldn't find a valid API key on this request.no₹0
402WALLET_INSUFFICIENT_BALANCEYour wallet doesn't have enough for this call, so we didn't run it.no₹0
404RECORD_NOT_FOUNDThe source has no record for this ID.no₹0
429RATE_LIMITEDYou sent requests faster than your key's limit.yes₹0
503PROVIDER_UNAVAILABLEAll upstream sources for this check were down, even after fallback.yes₹0
504PROVIDER_TIMEOUTThe upstream source took too long to answer.yes₹0

₹3.50

Company Search · incl. GST · failed calls ₹0

Get early access