Finpass API Collection
  1. Corporate
  • Introduction
  • Bank Statement Analyser
    • Upload Statement
      POST
    • Statement Result
      GET
  • Account Aggregator
    • Initialize
      POST
    • Fetch JSON Report
      POST
    • Fetch PDF Report
      POST
    • Refresh Data
      POST
  • Multi Bureau
    • Multi-Bureau Fetch
      POST
  • Corporate
    • CIN Lookup
      POST
    • LLPIN
      POST
    • PAN Lookup
      POST
    • Company Autocomplete
      POST
  • EPFO
    • EPFO-CRIF Combined Report
      POST
  • ITR Analyzer
    • Initialize
      POST
    • Status
      GET
    • ITR Analyzer — Get Full Data
      GET
  • AA-BSA Analyzer
    • Initialize
      POST
    • Status
      GET
    • AA BSA — Statement Result
      GET
    • AA BSA — Analysis JSON
      GET
  1. Corporate

Company Autocomplete

POST
/api/v1/corporate/company-autocomplete

Company Autocomplete#

Endpoint Overview
POST /api/v1/corporate/company-autocomplete

Description#

The Company Autocomplete API provides real-time search suggestions for Indian registered companies and LLPs based on a partial or full company name input. It queries the Ministry of Corporate Affairs (MCA) registry to return a ranked list of matching entity names along with their associated identifiers (CIN/LLPIN) and basic metadata.
This API is designed to power name-search dropdowns, autofill fields, and entity discovery flows in your application — enabling users to quickly identify and select the correct legal entity without needing to know its exact registered name or identifier upfront. It significantly reduces data entry friction and lookup errors during onboarding and verification workflows.
Key Benefits
Deliver instant, MCA-sourced company name suggestions as users type — no exact name required
Reduce user errors in entity selection by presenting verified legal names with unique identifiers
Accelerate KYB onboarding by combining autocomplete with downstream CIN or LLPIN lookup APIs
Support discovery of both companies and LLPs through a single unified search interface

Use Cases#

Banking & Lending
Fintech & Payments
Enterprise & Compliance
Power entity name search fields during business loan application forms
Allow relationship managers to quickly locate a corporate borrower by partial name
Reduce name-entry errors in onboarding workflows by presenting selectable verified names

Technical Implementation#

1
Authentication
All API requests require authentication using your Finpass API credentials passed as request headers.
1.
Obtain API Credentials: Register with Finpass to receive your X-API-KEY and X-API-SECRET.
2.
Include in Requests: Add both keys to every request as HTTP headers.
HeaderValue
X-API-KEYYour assigned API Key
X-API-SECRETYour assigned API Secret
Base URL: https://api.finpass.ai
2
Request Parameters

Request Headers#

HeaderRequiredDescription
Content-TypeYesMust be application/json
X-API-KEYYesYour Finpass API Key
X-API-SECRETYesYour Finpass API Secret

Request Body#

ParameterTypeRequiredDescription
company_namestringYesPartial or full name of the company or LLP to search for (e.g., TATA). Input is case-insensitive and will be automatically uppercased. Minimum of 3 characters recommended for meaningful results.

Example Request#

{
  "company_name": "TATA"
}
3
Process Response

Response Parameters#

ParameterTypeDescription
successbooleanIndicates whether the request was processed successfully
messagestringHuman-readable status message
dataarrayList of matching entity objects returned from the MCA registry
data[].entity_namestringRegistered legal name of the matching entity
data[].entity_typestringType of entity — Company or LLP
data[].cinstringCorporate Identification Number, present if the entity is a company (null for LLPs)
data[].llpinstringLLPIN, present if the entity is an LLP (null for companies)
data[].statusstringCurrent registration status of the entity (e.g., Active, Struck Off)
data[].statestringState in which the entity is registered
total_resultsnumberTotal number of matching entities returned in this response

Example Successful Response#

{
  "success": true,
  "message": "Autocomplete results fetched successfully",
  "total_results": 3,
  "data": [
    {
      "entity_name": "TATA CONSULTANCY SERVICES LIMITED",
      "entity_type": "Company",
      "cin": "L22210MH1995PLC084781",
      "llpin": null,
      "status": "Active",
      "state": "Maharashtra"
    },
    {
      "entity_name": "TATA MOTORS LIMITED",
      "entity_type": "Company",
      "cin": "L28920MH1945PLC004520",
      "llpin": null,
      "status": "Active",
      "state": "Maharashtra"
    },
    {
      "entity_name": "TATA CAPITAL FINANCIAL SERVICES LLP",
      "entity_type": "LLP",
      "cin": null,
      "llpin": "AAB-2345",
      "status": "Active",
      "state": "Maharashtra"
    }
  ]
}

Possible Error Responses#

Missing or Short Input
No Results Found
Unauthorized
{
  "success": false,
  "message": "company_name is required and must be at least 3 characters long.",
  "error_code": "INVALID_INPUT"
}
Returned when company_name is missing or too short to return meaningful autocomplete results.

Integration Best Practices#

Security Recommendations
Never expose your X-API-KEY and X-API-SECRET in client-side code or frontend JavaScript; proxy all requests through your backend
Implement rate limiting on your server to prevent abuse of the autocomplete endpoint by bots or scrapers
Rotate your API credentials periodically and revoke compromised keys immediately via the Finpass dashboard
Ensure all communication between your backend and the Finpass API occurs over HTTPS
User Experience Guidelines
Debounce autocomplete API calls with a 300–500ms delay after the user stops typing to minimise unnecessary requests and improve performance
Require a minimum of 3 characters before triggering the autocomplete call to avoid overly broad or irrelevant result sets
Display the entity type (Company/LLP) and state alongside the entity name in the dropdown to help users distinguish between similarly named entities
Once the user selects an entity from the autocomplete list, use the returned CIN or LLPIN to automatically trigger a deeper lookup via the CIN Lookup or LLPIN Lookup API
Handle the empty result state gracefully with a "No matching companies found" message rather than a blank dropdown

Code Samples#

cURL
Python
Node.js
Related APIs
CIN Lookup — Retrieve full company details using a CIN obtained from an autocomplete selection
LLPIN Lookup — Retrieve full LLP details using an LLPIN obtained from an autocomplete selection
PAN Lookup — Fetch entity details using a corporate PAN as an alternative lookup identifier
Compliance and Legal Considerations
This API surfaces publicly available entity names and identifiers from the Ministry of Corporate Affairs (MCA) registry. While the data is public, your application must handle it responsibly and in compliance with applicable laws, including the Digital Personal Data Protection Act (DPDP), 2023. Do not use autocomplete results to build unsolicited marketing lists or for any purpose not disclosed to your end users. When combining autocomplete with deeper lookup APIs, ensure the downstream data handling adheres to your privacy policy and applicable regulatory requirements. Access to this endpoint requires the COMPANY_AUTOCOMPLETE permission on your Finpass account.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.finpass.ai/api/v1/corporate/company-autocomplete' \
--header 'Content-Type: application/json' \
--data-raw '{
    "company_name": "TATA"
}'
Response Response Example
{
    "doc_id": "companyauto_69d379fa_5a40b7e928d87edfb50b24dd",
    "company_name": "AMERICAN",
    "result": [
        {
            "company_name": "AMERICAN REMEDIES LIMITED",
            "cin": "L24294TN1986PLC012121",
            "category": "ltd"
        },
        {
            "company_name": "AMERICAN CHASE LLP",
            "cin": "AAJ-6711",
            "category": "llp"
        },
        {
            "company_name": "AMERICAN METALS LIMITED",
            "cin": "U99999MH1941PTC003473",
            "category": "ltd"
        },
        {
            "company_name": "AMERICAN REALTY LIMITED",
            "cin": "U70112TN2004PLC053573",
            "category": "ltd"
        },
        {
            "company_name": "AMERICAN FORMULARY LIMITED",
            "cin": "U1544KA2001PLC029745",
            "category": "ltd"
        },
        {
            "company_name": "AMERICAN EXHIBITION LLP",
            "cin": "ABA-2102",
            "category": "llp"
        },
        {
            "company_name": "AMERICAN GLOBAL LLP",
            "cin": "ACG-2117",
            "category": "llp"
        }
    ]
}
Previous
PAN Lookup
Next
EPFO-CRIF Combined Report
Built with