Company Name Search

Business & KYB

Find companies and LLPs by name and get their CIN or LLPIN.

Type-ahead search across the corporate registry: send a partial name and receive matching entities with their identifiers, status and state so users pick the right company before a full lookup.

Endpoint

POST https://app.emver.io/api/sandbox/v1/company-search

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`query` required	string	Company name (partial allowed)
`state` optional	string	State filter

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/company-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "query": "string",
    "state": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/company-search",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "query": "string",
        "state": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/company-search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "query": "string",
      "state": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/company-search', {
        "query": "string",
        "state": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING,
  "data": {
    "results": ARRAY
  }
}

Example · 200

{
  "status": 200,
  "message": "string",
  "data": {
    "results": "string"
  }
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

Use it to power an autocomplete field in onboarding forms, then pass the selected CIN to Company Lookup for the full record.

Typical uses

B2B onboarding forms. Pick the legal entity, then verify it.
Investigations. Find every entity sharing a name fragment.

Questions

Are LLPs included?: Yes, results carry an entity type so you can distinguish companies from LLPs.