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

PAN Lookup

POST
/api/v1/corporate/pan-lookup

PAN Lookup#

Endpoint Overview
POST /api/v1/corporate/pan-lookup

Description#

The PAN Lookup API enables you to retrieve corporate entity information using a Permanent Account Number (PAN). PAN is a 10-character alphanumeric identifier issued by the Income Tax Department of India to all taxable entities — including companies, LLPs, partnership firms, and trusts.
This API resolves a PAN to its corresponding corporate profile sourced from MCA and tax authority records, returning key details such as entity name, entity type, registration status, and linked identifiers (CIN/LLPIN). It is especially useful in scenarios where a CIN or LLPIN is not immediately available but a PAN is known — such as during financial due diligence, income tax verification, or banking onboarding.
Key Benefits
Resolve any corporate PAN to a verified legal entity profile without needing a CIN or LLPIN upfront
Streamline tax-linked identity verification for businesses across entity types (companies, LLPs, trusts)
Cross-validate PAN submitted by applicants against official registry data to detect mismatches
Enable unified corporate identity lookup across multiple identifier types within a single platform

Use Cases#

Banking & Lending
Fintech & Payments
Enterprise & Compliance
Verify corporate PAN during business account opening and loan origination
Cross-check submitted PAN against registry-linked entity name and type to detect fraud
Retrieve CIN or LLPIN from PAN to initiate deeper corporate verification workflows

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
panstringYesThe 10-character Permanent Account Number of the corporate entity (e.g., AABCT1234E). Input is case-insensitive and will be automatically uppercased.

Example Request#

{
  "pan": "AABCT1234E"
}
3
Process Response

Response Parameters#

ParameterTypeDescription
successbooleanIndicates whether the request was processed successfully
messagestringHuman-readable status message
dataobjectContains the entity details resolved from the PAN
data.panstringThe PAN provided in the request
data.entity_namestringRegistered legal name of the entity linked to the PAN
data.entity_typestringType of entity associated with the PAN (e.g., Company, LLP, Trust, Firm)
data.statusstringCurrent registration or tax status of the entity
data.cinstringCorporate Identification Number, if the entity is a registered company (null for LLPs)
data.llpinstringLLPIN, if the entity is a registered LLP (null for companies)
data.date_of_incorporationstringDate the entity was incorporated or registered (YYYY-MM-DD)
data.registered_addressstringOfficial registered address of the entity
data.statestringState in which the entity is registered

Example Successful Response#

{
  "success": true,
  "message": "Entity details fetched successfully",
  "data": {
    "pan": "AABCT1234E",
    "entity_name": "EXAMPLE TECHNOLOGIES PRIVATE LIMITED",
    "entity_type": "Company",
    "status": "Active",
    "cin": "U72200MH2019PTC321654",
    "llpin": null,
    "date_of_incorporation": "2019-09-10",
    "registered_address": "789, Innovation Tower, Powai, Mumbai - 400076",
    "state": "Maharashtra"
  }
}

Possible Error Responses#

Invalid PAN
PAN Not Found
Unauthorized
{
  "success": false,
  "message": "Invalid PAN format. PAN must be a 10-character alphanumeric string.",
  "error_code": "INVALID_INPUT"
}
Returned when the provided PAN does not match the standard 10-character alphanumeric PAN 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
Treat resolved PAN data as sensitive financial information — store it encrypted and apply strict access controls
Rotate your API credentials periodically and monitor usage logs for anomalous call patterns
Ensure all API calls are made over HTTPS and that your backend validates SSL certificates
User Experience Guidelines
Validate PAN format on the client side (10 alphanumeric characters matching the pattern [A-Z]{5}[0-9]{4}[A-Z]) before making the API call
Clearly communicate to users that their PAN is being used solely for identity verification purposes
When the response includes both cin and llpin as null, surface a message indicating the entity may not be a company or LLP
Cache PAN lookup results briefly (e.g., a few hours) to avoid redundant calls for the same PAN within the same session

Code Samples#

cURL
Python
Node.js
Related APIs
CIN Lookup — Retrieve detailed company information directly using a Corporate Identification Number
LLPIN Lookup — Retrieve LLP details using a Limited Liability Partnership Identification Number
Company Autocomplete — Search and discover companies and LLPs by name with autocomplete suggestions
Compliance and Legal Considerations
PAN is a sensitive tax identifier regulated by the Income Tax Department of India. Ensure that your collection and processing of PAN data complies with applicable laws, including the Income Tax Act, 1961, and the Digital Personal Data Protection Act (DPDP), 2023. Obtain explicit consent from your end users before collecting or processing their PAN for verification purposes. Do not store raw PAN data beyond the period required for verification unless legally mandated to do so. Access to this endpoint requires the CORPORATE_PAN 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/pan-lookup' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pan": "AABCT1234E"
}'
Response Response Example
{
    "success": true,
    "message": "PAN lookup successful",
    "data": {
        "doc_id": "pan456mno789",
        "pan": "AABCA1234B",
        "result": {
            "client_id": "CL-55443",
            "pan": "AABCA1234B",
            "entity_type": "Company",
            "legal_name": "ACME TECHNOLOGIES PRIVATE LIMITED",
            "cin": "U72200MH2010PTC123456",
            "date_of_registration": "2010-05-15",
            "registered_address": "101, Tech Park, Andheri East, Mumbai - 400069, Maharashtra",
            "status": "Active",
            "company": {
                "legal_name": "ACME TECHNOLOGIES PRIVATE LIMITED",
                "cin": "U72200MH2010PTC123456",
                "company_category": "Company limited by Shares",
                "class_of_company": "Private",
                "registered_office_address": "101, Tech Park, Andheri East, Mumbai - 400069, Maharashtra",
                "date_of_incorporation": "2010-05-15",
                "authorised_capital": 10000000,
                "paid_up_capital": 5000000
            },
            "gst_details": [
                {
                    "gstin": "27AABCA1234B1ZX",
                    "state": "Maharashtra",
                    "status": "Active",
                    "taxpayer_type": "Regular",
                    "filing_timeliness": "Timely",
                    "date_of_registration": "2017-07-01"
                },
                {
                    "gstin": "29AABCA1234B1ZY",
                    "state": "Karnataka",
                    "status": "Active",
                    "taxpayer_type": "Regular",
                    "filing_timeliness": "Timely",
                    "date_of_registration": "2018-01-15"
                }
            ],
            "itr_filing_history": [
                {
                    "assessment_year": "2024-25",
                    "filing_date": "2024-10-28",
                    "return_type": "Original",
                    "status": "Filed"
                },
                {
                    "assessment_year": "2023-24",
                    "filing_date": "2023-10-25",
                    "return_type": "Original",
                    "status": "Filed"
                }
            ],
            "tds_tcs_compliance": {
                "tds_defaults": false,
                "last_tds_filing_date": "2024-10-15",
                "filing_timeliness": "Timely"
            },
            "key_indicators": {
                "profit": 98200000,
                "bureau_defaults": false,
                "gst_filing_delay": false
            },
            "directors": [
                {
                    "name": "Rajan Mehta",
                    "designation": "Managing Director",
                    "din": "01234567"
                },
                {
                    "name": "Priya Sharma",
                    "designation": "Director",
                    "din": "07654321"
                }
            ]
        }
    }
}
Previous
LLPIN
Next
Company Autocomplete
Built with