CIN Lookup

Endpoint Overview

POST /api/v1/corporate/cin-lookup

Description

The CIN Lookup API allows you to retrieve detailed corporate information for a registered company using its Corporate Identification Number (CIN). The CIN is a 21-character alphanumeric identifier assigned by the Ministry of Corporate Affairs (MCA) to every registered company in India.

This API provides instant access to official MCA-registered data including company name, registration status, incorporation date, registered address, authorised and paid-up capital — enabling faster onboarding, due diligence, and compliance workflows.

Key Benefits

Instantly fetch verified company data directly from MCA records using just the CIN

Automate KYB (Know Your Business) workflows and reduce manual verification overhead

Enhance fraud detection by cross-referencing submitted documents against official registry data

Accelerate lending, onboarding, and partnership due diligence processes

Use Cases

Banking & Lending

Fintech & Payments

Enterprise & Compliance

Verify corporate borrower identity before disbursing business loans

Cross-check CIN against submitted incorporation certificates during credit underwriting

Monitor company status changes (Active/Struck Off) for existing loan portfolios

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
`cin`	string	Yes	The 21-character Corporate Identification Number of the company (e.g., `U74999MH2021PTC123456`). Input is case-insensitive and will be automatically uppercased.

Example Request

{
  "cin": "U74999MH2021PTC123456"
}

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 company details retrieved from MCA records
`data.cin`	string	The Corporate Identification Number of the company
`data.company_name`	string	Registered legal name of the company
`data.status`	string	Current status of the company (e.g., Active, Struck Off)
`data.company_type`	string	Type/category of the company (e.g., Private Limited)
`data.date_of_incorporation`	string	Date the company was incorporated (YYYY-MM-DD)
`data.registered_address`	string	Official registered address as per MCA records
`data.state`	string	State in which the company is registered
`data.roc_code`	string	Registrar of Companies code under which the company is registered
`data.authorised_capital`	number	Authorised share capital of the company (in INR)
`data.paid_up_capital`	number	Paid-up share capital of the company (in INR)
`data.email`	string	Registered email address of the company
`data.pan`	string	Permanent Account Number of the company

Example Successful Response

{
  "success": true,
  "message": "Company details fetched successfully",
  "data": {
    "cin": "U74999MH2021PTC123456",
    "company_name": "EXAMPLE PRIVATE LIMITED",
    "status": "Active",
    "company_type": "Private Limited",
    "date_of_incorporation": "2021-06-15",
    "registered_address": "123, Business Park, Andheri East, Mumbai - 400069",
    "state": "Maharashtra",
    "roc_code": "RoC-Mumbai",
    "authorised_capital": 1000000,
    "paid_up_capital": 100000,
    "email": "contact@example.com",
    "pan": "AABCE1234F"
  }
}

Possible Error Responses

Invalid CIN

CIN Not Found

Unauthorized

{
  "success": false,
  "message": "Invalid CIN format. CIN must be a 21-character alphanumeric string.",
  "error_code": "INVALID_INPUT"
}

Returned when the provided CIN does not match the expected 21-character alphanumeric 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

Implement IP whitelisting on your backend to restrict which servers can call the Finpass API

Log all API calls with timestamps and requester identity for audit trail purposes

User Experience Guidelines

Validate the CIN format on the client side (21 alphanumeric characters) before making the API call to reduce unnecessary requests

Display a loading state while the lookup is in progress, as response times may vary based on MCA registry availability

Surface actionable error messages to end users (e.g., "Company not found — please check the CIN and try again") rather than raw error codes

Cache successful CIN lookup responses for a short duration (e.g., 24 hours) to improve performance for repeated lookups of the same entity

Code Samples

cURL

Python

Node.js

Related APIs

LLPIN Lookup — Retrieve details of a Limited Liability Partnership using its LLPIN

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

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

Compliance and Legal Considerations

Data retrieved through this API is sourced from the Ministry of Corporate Affairs (MCA) public registry. Ensure your use of this data complies with applicable data protection regulations, including the Digital Personal Data Protection Act (DPDP), 2023. This API must only be used for lawful purposes such as KYB, fraud prevention, credit underwriting, and regulatory compliance. Do not use the retrieved data for unsolicited communications or any purpose not disclosed to your end users. Retain API call logs and consent records as required by your regulatory framework. Access to this endpoint requires the CORPORATE_CIN permission on your Finpass account.

{ "success": true, "message": "CIN lookup successful", "data": { "doc_id": "abc123def456", "cin": "U72200MH2010PTC123456", "pdf_url": "https://s3.amazonaws.com/bucket/corporate_cin/abc123def456/company_dna_report.pdf", "result": { "client_id": "CL-98765", "company": { "legal_name": "ACME TECHNOLOGIES PRIVATE LIMITED", "cin": "U72200MH2010PTC123456", "registration_number": "123456", "date_of_incorporation": "2010-05-15", "company_category": "Company limited by Shares", "company_sub_category": "Non-govt company", "class_of_company": "Private", "registered_office_address": "101, Tech Park, Andheri East, Mumbai - 400069, Maharashtra", "email": "info@acmetech.com", "authorised_capital": 10000000, "paid_up_capital": 5000000, "number_of_members": null, "activity": "Software Development and IT Services" }, "description": { "desc_thousand_char": "Acme Technologies Private Limited is a leading IT services company headquartered in Mumbai, India. Founded in 2010, the company specialises in enterprise software development, cloud solutions, and digital transformation services for clients across BFSI, retail, and manufacturing sectors.", "summary": "IT services and software development company based in Mumbai." }, "contact_details": { "email": [ { "emailId": "info@acmetech.com" }, { "emailId": "finance@acmetech.com" } ], "phone": [ { "phoneNumber": "02240123456" }, { "phoneNumber": "09876543210" } ] }, "principal_business_activities": [ { "main_activity_group_description": "Information Technology", "business_activity_description": "Software Development", "percentage_of_turnover": 85.5 }, { "main_activity_group_description": "Consulting", "business_activity_description": "IT Consulting Services", "percentage_of_turnover": 14.5 } ], "filing_dates": { "annual_return_date": "2024-09-30", "balance_sheet_date": "2024-10-15", "last_agm_date": "2024-09-25" }, "key_indicators": { "revenue": 450000000, "profit": 52000000, "employee_count": 320, "pending_cases_filed_against_this_corporate": false, "bureau_defaults": false, "gst_filing_delay": false, "epf_payment_delay": false }, "finpass_financial_score": { "overall_financial_score": 4, "growth_score": 4, "profitability_score": 3, "liquidity_score": 4, "solvency_score": 5, "efficiency_score": 3 }, "financials": [ { "nature": "STANDALONE", "year": "2023-03-31", "pnl": { "lineItems": { "net_revenue": 380000000, "total_cost_of_materials_consumed": 0, "total_purchases_of_stock_in_trade": 0, "total_changes_in_inventories_or_finished_goods": 0, "total_employee_benefit_expense": 210000000, "total_other_expenses": 55000000, "operating_profit": 115000000, "other_income": 8000000, "depreciation": 12000000, "interest": 3500000, "profit_before_tax": 107500000, "income_tax": 28000000, "profit_after_tax": 79500000 } }, "bs": { "assets": { "tangible_assets": 45000000, "intangible_assets": 5000000, "tangible_assets_capital_work_in_progress": 2000000, "noncurrent_investments": 15000000, "deferred_tax_assets_net": 3000000, "long_term_loans_and_advances": 8000000, "current_investments": 20000000, "inventories": 0, "trade_receivables": 85000000, "cash_and_bank_balances": 62000000, "short_term_loans_and_advances": 12000000, "other_current_assets": 18000000, "other_noncurrent_assets": 5000000, "given_assets_total": 280000000 }, "liabilities": { "share_capital": 5000000, "reserves_and_surplus": 175000000, "long_term_borrowings": 10000000, "deferred_tax_liabilities_net": 0, "other_long_term_liabilities": 5000000, "long_term_provisions": 8000000, "short_term_borrowings": 5000000, "trade_payables": 35000000, "other_current_liabilities": 28000000, "short_term_provisions": 9000000, "given_liabilities_total": 280000000 }, "subTotals": { "total_equity": 18, "total_debt": 1.5, "net_fixed_assets": 5.0 } }, "cash_flow": { "cash_flows_from_used_in_operating_activities": 92000000, "cash_flows_from_used_in_investing_activities": -18000000, "cash_flows_from_used_in_financing_activities": -12000000, "incr_decr_in_cash_cash_equv": 62000000, "cash_flow_statement_at_end_of_period": 62000000 }, "ratios": { "revenue_growth": 18.5, "gross_profit_margin": 44.7, "net_margin": 20.9, "ebitda_margin": 33.4, "return_on_equity": 34.2, "return_on_capital_employed": 28.6, "debt_by_equity": 0.08, "debt_ratio": 0.05, "current_ratio": 2.4, "quick_ratio": 2.4, "interest_coverage_ratio": 31.7, "inventory_by_sales_days": 0, "debtors_by_sales_days": 82, "payables_by_sales_days": 33, "cash_conversion_cycle": 49, "sales_by_net_fixed_assets": 8.4 }, "auditor": { "auditor_firm_name": "Deloitte Haskins & Sells LLP", "auditor_name": "Ramesh Kumar", "firm_registration_number": "117365W/W-100018" } }, { "nature": "STANDALONE", "year": "2024-03-31", "pnl": { "lineItems": { "net_revenue": 450000000, "total_employee_benefit_expense": 248000000, "total_other_expenses": 62000000, "operating_profit": 140000000, "other_income": 9500000, "depreciation": 14000000, "interest": 2800000, "profit_before_tax": 132700000, "income_tax": 34500000, "profit_after_tax": 98200000 } }, "bs": { "assets": { "tangible_assets": 52000000, "intangible_assets": 6000000, "noncurrent_investments": 22000000, "deferred_tax_assets_net": 4000000, "long_term_loans_and_advances": 9000000, "current_investments": 30000000, "trade_receivables": 95000000, "cash_and_bank_balances": 78000000, "short_term_loans_and_advances": 15000000, "other_current_assets": 22000000, "given_assets_total": 333000000 }, "liabilities": { "share_capital": 5000000, "reserves_and_surplus": 248000000, "long_term_borrowings": 8000000, "other_long_term_liabilities": 6000000, "long_term_provisions": 10000000, "short_term_borrowings": 3000000, "trade_payables": 22000000, "other_current_liabilities": 20000000, "short_term_provisions": 11000000, "given_liabilities_total": 333000000 }, "subTotals": { "total_equity": 25.3, "total_debt": 1.1, "net_fixed_assets": 5.8 } }, "cash_flow": { "cash_flows_from_used_in_operating_activities": 115000000, "cash_flows_from_used_in_investing_activities": -25000000, "cash_flows_from_used_in_financing_activities": -10000000, "incr_decr_in_cash_cash_equv": 80000000, "cash_flow_statement_at_end_of_period": 78000000 }, "ratios": { "revenue_growth": 18.4, "gross_profit_margin": 47.2, "net_margin": 21.8, "ebitda_margin": 34.2, "return_on_equity": 38.5, "return_on_capital_employed": 31.2, "debt_by_equity": 0.04, "debt_ratio": 0.03, "current_ratio": 2.8, "quick_ratio": 2.8, "interest_coverage_ratio": 48.5, "debtors_by_sales_days": 77, "payables_by_sales_days": 29, "cash_conversion_cycle": 48, "sales_by_net_fixed_assets": 7.8 }, "auditor": { "auditor_firm_name": "Deloitte Haskins & Sells LLP", "auditor_name": "Ramesh Kumar", "firm_registration_number": "117365W/W-100018" } } ], "holding_entities": { "company": [ { "legal_name": "GLOBAL TECH HOLDINGS PVT LTD", "share_holding_percentage": 65.0 } ], "llp": [], "others": [] }, "subsidiary_entities": { "company": [ { "legal_name": "ACME DATA SOLUTIONS PVT LTD", "share_holding_percentage": 100.0 } ], "llp": [], "others": [] }, "associate_entities": null, "joint_ventures": null, "authorized_signatories": [ { "name": "Rajan Mehta", "designation": "Managing Director", "din": "01234567", "date_of_appointment_for_current_designation": "2010-05-15", "date_of_cessation": null }, { "name": "Priya Sharma", "designation": "Director", "din": "07654321", "date_of_appointment_for_current_designation": "2015-03-01", "date_of_cessation": null }, { "name": "Suresh Patel", "designation": "Director", "din": "09988776", "date_of_appointment_for_current_designation": "2012-07-10", "date_of_cessation": "2022-09-30" } ], "director_network": [ { "name": "Rajan Mehta", "network": { "companies": [ { "legal_name": "ACME DATA SOLUTIONS PVT LTD", "designation": "Director" }, { "legal_name": "MEHTA VENTURES PVT LTD", "designation": "Director" } ], "llps": [] } } ], "shareholdings": [ { "financial_year": "2024", "shareholders": "Promoter", "category": "Indian Promoters", "indian_held_no_of_shares": 325000, "indian_held_percentage_of_shares": 65.0, "nri_held_no_of_shares": 0, "nri_held_percentage_of_shares": 0, "foreign_held_other_than_nri_no_of_shares": 0, "foreign_held_other_than_nri_percentage_of_shares": 0 }, { "financial_year": "2024", "shareholders": "Public", "category": "Institutional Investors", "indian_held_no_of_shares": 125000, "indian_held_percentage_of_shares": 25.0, "nri_held_no_of_shares": 0, "nri_held_percentage_of_shares": 0, "foreign_held_other_than_nri_no_of_shares": 50000, "foreign_held_other_than_nri_percentage_of_shares": 10.0 } ], "shareholdings_summary": [ { "financial_year": "2024", "total_equity_shares": 500000, "total_preference_shares": 0, "promoter": 3, "public": 45, "total": 48 } ], "shareholdings_more_than_five_percent": [ { "financial_year": "2024", "company": [ { "company_name": "GLOBAL TECH HOLDINGS PVT LTD", "no_of_shares": 325000, "percentage": 65.0 } ], "individual": [ { "name": "Rajan Mehta", "no_of_shares": 50000, "percentage": 10.0 } ], "llp": [], "others": [] } ], "director_shareholdings": [ { "full_name": "Rajan Mehta", "designation": "Managing Director", "no_of_shares": 50000, "percentage_holding": 10.0 } ], "securities_allotment": [ { "allotment_date": "2018-06-15", "number_of_securities_allotted": 100000, "total_amount_raised": 50000000, "instrument": "Equity Shares" } ], "credit_ratings": [ { "rating_date": "2024-01-10", "rating_agency": "CRISIL", "rating": "A-", "type_of_loan": "Term Loan", "amount": 80000000 } ], "gst_details": [ { "gstin": "27AABCA1234B1ZX", "state": "Maharashtra", "status": "Active", "taxpayer_type": "Regular", "filing_timeliness": "Timely" }, { "gstin": "29AABCA1234B1ZY", "state": "Karnataka", "status": "Active", "taxpayer_type": "Regular", "filing_timeliness": "Timely" } ], "open_charges": [], "legal_cases_of_financial_disputes": {}, "legal_history": [], "msme_supplier_payment_delays": { "trend": [], "delays_for_period": { "latest_period": "2024-03-31", "total_amount_due_for_period": 0, "delays": [] } }, "related_party_transactions": [ { "financial_year": "2024", "company": [ { "name": "ACME DATA SOLUTIONS PVT LTD", "relationship": "Subsidiary", "type_of_transaction": "IT Services", "amount": 12000000 } ], "individual": [], "llp": [], "others": [] } ], "industry_segments": [ { "industry": "Information Technology", "segments": [ "Enterprise Software", "Cloud Services", "IT Consulting" ] } ], "establishments_registered_with_epfo": [ { "establishment_name": "ACME TECHNOLOGIES PRIVATE LIMITED", "state": "Maharashtra", "employee_count": 320 } ], "struckoff248_details": { "struck_off_status": "Not Struck Off" }, "peer_comparison": [], "financial_parameters": { "csr_expenditure": 500000, "dividend_paid": 2500000 } } } }

CIN Lookup

CIN 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

CIN 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