LLPIN Lookup

Endpoint Overview

POST /api/v1/corporate/llpin-lookup

Description

The LLPIN Lookup API enables you to retrieve detailed information about a Limited Liability Partnership (LLP) registered in India using its Limited Liability Partnership Identification Number (LLPIN). The LLPIN is a unique alphanumeric identifier assigned by the Ministry of Corporate Affairs (MCA) to every LLP incorporated under the Limited Liability Partnership Act, 2008.

This API surfaces official MCA registry data including the LLP name, registration status, date of incorporation, registered address, total obligation of contribution, and designated partner details — making it an essential tool for business verification, credit decisioning, and compliance checks involving LLP entities.

Key Benefits

Instantly verify LLP identity and registration status using a single identifier

Distinguish LLP entities from companies during KYB and onboarding workflows

Reduce manual verification effort by pulling structured, registry-sourced LLP data programmatically

Support risk assessments and fraud checks on LLP-structured borrowers or business partners

Use Cases

Banking & Lending

Fintech & Payments

Enterprise & Compliance

Verify LLP registration and status before approving business credit facilities

Retrieve contribution details to assess financial standing of LLP borrowers

Validate designated partners of an LLP during loan underwriting processes

Technical Implementation

Authentication

All API requests require authentication using your Finpass API credentials passed as request headers.

Obtain API Credentials: Register with Finpass to receive your X-API-KEY and X-API-SECRET.

Include in Requests: Add both keys to every request as HTTP headers.

Header	Value
`X-API-KEY`	Your assigned API Key
`X-API-SECRET`	Your assigned API Secret

Base URL: https://api.finpass.ai

Request Parameters

Request Headers

Header	Required	Description
`Content-Type`	Yes	Must be `application/json`
`X-API-KEY`	Yes	Your Finpass API Key
`X-API-SECRET`	Yes	Your Finpass API Secret

Request Body

Parameter	Type	Required	Description
`llpin`	string	Yes	The LLPIN of the Limited Liability Partnership (e.g., `AAA-1234`). Input is case-insensitive and will be automatically uppercased.

Example Request

{
  "llpin": "AAA-1234"
}

Process Response

Response Parameters

Parameter	Type	Description
`success`	boolean	Indicates whether the request was processed successfully
`message`	string	Human-readable status message
`data`	object	Contains the LLP details retrieved from MCA records
`data.llpin`	string	The LLPIN of the Limited Liability Partnership
`data.llp_name`	string	Registered legal name of the LLP
`data.status`	string	Current registration status of the LLP (e.g., Active, Defunct)
`data.date_of_incorporation`	string	Date the LLP was incorporated (YYYY-MM-DD)
`data.registered_address`	string	Official registered address of the LLP as per MCA records
`data.state`	string	State in which the LLP is registered
`data.roc_code`	string	Registrar of Companies code under which the LLP is registered
`data.total_obligation_of_contribution`	number	Total financial obligation of contribution of the LLP (in INR)
`data.email`	string	Registered email address of the LLP
`data.pan`	string	Permanent Account Number of the LLP

Example Successful Response

{
  "success": true,
  "message": "LLP details fetched successfully",
  "data": {
    "llpin": "AAA-1234",
    "llp_name": "EXAMPLE SERVICES LLP",
    "status": "Active",
    "date_of_incorporation": "2018-03-22",
    "registered_address": "456, Tech Hub, Koramangala, Bengaluru - 560034",
    "state": "Karnataka",
    "roc_code": "RoC-Bangalore",
    "total_obligation_of_contribution": 500000,
    "email": "info@exampleservices.com",
    "pan": "AACJE5678G"
  }
}

Possible Error Responses

Invalid LLPIN

LLPIN Not Found

Unauthorized

{
  "success": false,
  "message": "Invalid LLPIN format. Please provide a valid LLPIN (e.g., AAA-1234).",
  "error_code": "INVALID_INPUT"
}

Returned when the provided LLPIN does not match the expected format.

Integration Best Practices

Security Recommendations

Never expose your X-API-KEY and X-API-SECRET in client-side code or public repositories; always call this API from a secure backend service

Rotate your API credentials periodically and revoke any compromised keys immediately via the Finpass dashboard

Restrict API access to trusted server IPs using network-level controls or firewall rules

Ensure all API traffic is transmitted over HTTPS to prevent credential interception

User Experience Guidelines

Validate the LLPIN format client-side before making the API call to avoid unnecessary round trips

Clearly distinguish LLP results from company results in your UI — LLPs have designated partners, not directors

Show a meaningful loading indicator during the lookup, as registry queries can take a moment

Cache LLPIN lookup results for a reasonable period (e.g., 24 hours) to optimise performance for repeat lookups

Code Samples

cURL

Python

Node.js

Related APIs

CIN Lookup — Retrieve company details using a Corporate Identification Number for MCA-registered companies

PAN Lookup — Fetch corporate information using a company's or LLP's Permanent Account Number

Company Autocomplete — Search and discover companies and LLPs by name with autocomplete suggestions

Compliance and Legal Considerations

Data returned by this API is sourced from the Ministry of Corporate Affairs (MCA) public registry under the Limited Liability Partnership Act, 2008. Use of this data must comply with applicable data protection laws, including the Digital Personal Data Protection Act (DPDP), 2023. This API is intended solely for lawful business purposes such as KYB verification, credit underwriting, regulatory compliance, and fraud prevention. Ensure that your end users are informed of how their submitted identifiers are processed and that appropriate consent is obtained where required. Access to this endpoint requires the CORPORATE_LLPIN permission on your Finpass account.

LLPIN

LLPIN Lookup#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses