> ## Documentation Index > Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt > Use this file to discover all available pages before exploring further. # Company Master Data > API takes in the Corporate Identification Number (CIN) to identify and retrieve basic information about the company. ## OpenAPI ````yaml api-reference/kyc/openapi.json POST /mca/company/master-data/search openapi: 3.1.0 info: title: in-co-sandbox-kyc description: '' version: 1.0.0 servers: - url: https://test-api.sandbox.co.in description: test - url: https://api.sandbox.co.in description: prod security: [] tags: - name: kyc - name: digilocker-sdk - name: digilocker - name: aadhaar - name: bank - name: pan - name: mca - name: entitylocker - name: entitylocker-sdk paths: /mca/company/master-data/search: post: tags: - kyc - mca summary: Company Master Data description: Fetch companies's details using CIN or LLPIN operationId: getCompanyMasterData parameters: - name: Authorization in: header description: >- JWT access token. For token-generation steps, refer to the [Quickstart Guide](https://developer.sandbox.co.in/guides/get-started/quickstart). required: true example: '{{access_token}}' schema: type: string - name: x-api-key in: header description: API key used to identify and authenticate the client. required: true example: '{{api_key}}' schema: type: string - name: x-api-version in: header description: Specifies the API version for the request. required: false example: 1.0.0 schema: type: string - name: Content-Type in: header description: Media type of the request body. required: false example: application/json schema: type: string enum: - application/json requestBody: content: application/json: schema: type: object properties: '@entity': type: string enum: - in.co.sandbox.kyc.mca.master_data.request id: type: string description: >- Government-issued identification code of the entity being verified. minLength: 7 maxLength: 21 consent: type: string enum: - 'Y' - 'y' description: >- Explicit consent from the end user to retrieve and verify entity information. reason: type: string minLength: 20 description: >- Purpose for requesting verification of the entity’s information. required: - '@entity' - id - consent - reason additionalProperties: false examples: 200 - Success (LLP): value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: ABC-1234 consent: 'y' reason: For Company KYC summary: 200 - Success (LLP) 200 - Success (LLP) 2: value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: ABC-4567 consent: 'y' reason: For Company KYC summary: 200 - Success (LLP) 2 200 - Success (LLP) 3: value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: XXX-4567 consent: 'y' reason: For Company KYC summary: 200 - Success (LLP) 3 200 - Success (company): value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: U12345AB1234ABC123456 consent: 'y' reason: For Company KYC summary: 200 - Success (company) 200 - Success (company) 2: value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: U12345AB1234ABC456789 consent: 'y' reason: For Company KYC summary: 200 - Success (company) 2 200 - Success (company) 3: value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: U12345AB1234ABC789789 consent: 'y' reason: For Company KYC summary: 200 - Success (company) 3 not found: value: '@entity': in.co.sandbox.kyc.mca.master_data.request id: ABC-1231 consent: 'y' reason: For Company KYC summary: not found responses: '200': description: '' content: application/json: schema: type: object properties: {} examples: 200 - Success (LLP): summary: 200 - Success (LLP) value: code: 200 timestamp: 1000000000000 transaction_id: bb3e2bb3-3244-4c27-86f3-700caa03d58b data: '@entity': in.co.sandbox.kyc.mca.llp llp_master_data: '@entity': in.co.sandbox.kyc.mca.llp.master_data email_id: jane@doe.com registered_address: 1234, WILSON GARDEN BANGALORE Bangalore KA 560027 IN main_division_of_business_activity_to_be_carried_out_in_india: '74' previous_firm/_company_details,_if_applicable: '' llpin: ABC-1234 roc_code: RoC-Bangalore number_of_designated_partners: '2' date_of_incorporation: 24/04/2009 llp_name: JANE DOE CONSULTING LLP total_obligation_of_contribution: '15000' llp_status: Active description_of_main_division: Other Business Activities number_of_partners: '0' llp_strike_off/_amalgamated_date: '' status_under_cirp: '' rd_region: RD South East Region balance_sheets: - '@entity': in.co.sandbox.kyc.mca.llp.balance_sheet date_of_filing: 31/03/2023 financial_year: 31/03/2023 - '@entity': in.co.sandbox.kyc.mca.llp.balance_sheet date_of_filing: 31/03/2022 financial_year: 31/03/2022 annual_returns: - '@entity': in.co.sandbox.kyc.mca.llp.annual_return date_of_filing: 31/03/2023 financial_year: 31/03/2023 charges: [] directors/signatory_details: - '@entity': >- in.co.sandbox.kyc.mca.llp.directors_signatory_details end_date: '-' designation: Designated Partner din/pan: '99963999' begin_date: 31/03/2010 name: JANE DOE - '@entity': >- in.co.sandbox.kyc.mca.llp.directors_signatory_details end_date: '-' designation: Designated Partner din/pan: '99967999' begin_date: 31/03/2010 name: JACK DOE 200 - Success (LLP) 2: summary: 200 - Success (LLP) 2 value: code: 200 timestamp: 1000000000000 transaction_id: 971f6ce6-b1b1-4b5c-b1b1-41aca5cc8906 data: '@entity': in.co.sandbox.kyc.mca.llp llp_master_data: '@entity': in.co.sandbox.kyc.mca.llp.master_data email_id: arjun@doe.com registered_address: 48, SNEH NAGAR, PUNE, MAHARASHTRA, 400001 main_division_of_business_activity_to_be_carried_out_in_india: '74' previous_firm/_company_details,_if_applicable: '' llpin: ABC-4567 roc_code: RoC-Delhi number_of_designated_partners: '2' date_of_incorporation: 24/04/2009 llp_name: ARJUN DOE CONSULTING LLP total_obligation_of_contribution: '15000' llp_status: Active description_of_main_division: Other Business Activities number_of_partners: '0' llp_strike_off/_amalgamated_date: '' status_under_cirp: '' rd_region: RD South East Region balance_sheets: - '@entity': in.co.sandbox.kyc.mca.llp.balance_sheet date_of_filing: 31/03/2023 financial_year: 31/03/2023 - '@entity': in.co.sandbox.kyc.mca.llp.balance_sheet date_of_filing: 31/03/2022 financial_year: 31/03/2022 annual_returns: - '@entity': in.co.sandbox.kyc.mca.llp.annual_return date_of_filing: 31/03/2023 financial_year: 31/03/2023 charges: [] directors/signatory_details: - '@entity': >- in.co.sandbox.kyc.mca.llp.directors_signatory_details end_date: '-' designation: Designated Partner din/pan: '99963999' begin_date: 31/03/2010 name: JANE DOE - '@entity': >- in.co.sandbox.kyc.mca.llp.directors_signatory_details end_date: '-' designation: Designated Partner din/pan: '99967999' begin_date: 31/03/2010 name: JACK DOE 200 - Success (LLP) 3: summary: 200 - Success (LLP) 3 value: code: 200 timestamp: 1000000000000 transaction_id: b61f8c7f-92fd-4f98-8fd2-4529cba8f8b1 data: '@entity': in.co.sandbox.kyc.mca.llp llp_master_data: '@entity': in.co.sandbox.kyc.mca.llp.master_data email_id: priya@doe.com registered_address: 82, BAPU ROAD, CHEENAI, TAMIL NADU, 600001 main_division_of_business_activity_to_be_carried_out_in_india: '74' previous_firm/_company_details,_if_applicable: '' llpin: XXX-4567 roc_code: RoC-Cheenai number_of_designated_partners: '2' date_of_incorporation: 24/04/2009 llp_name: PRIYA DOE CONSULTING LLP total_obligation_of_contribution: '15000' llp_status: Active description_of_main_division: Other Business Activities number_of_partners: '0' llp_strike_off/_amalgamated_date: '' status_under_cirp: '' rd_region: RD South East Region balance_sheets: - '@entity': in.co.sandbox.kyc.mca.llp.balance_sheet date_of_filing: 31/03/2023 financial_year: 31/03/2023 - '@entity': in.co.sandbox.kyc.mca.llp.balance_sheet date_of_filing: 31/03/2022 financial_year: 31/03/2022 annual_returns: - '@entity': in.co.sandbox.kyc.mca.llp.annual_return date_of_filing: 31/03/2023 financial_year: 31/03/2023 charges: [] directors/signatory_details: - '@entity': >- in.co.sandbox.kyc.mca.llp.directors_signatory_details end_date: '-' designation: Designated Partner din/pan: '99963999' begin_date: 31/03/2010 name: JANE DOE - '@entity': >- in.co.sandbox.kyc.mca.llp.directors_signatory_details end_date: '-' designation: Designated Partner din/pan: '99967999' begin_date: 31/03/2010 name: JACK DOE 200 - Success (company): summary: 200 - Success (company) value: code: 200 timestamp: 1000000000000 transaction_id: ba5693d8-228b-443d-a485-1983b0131375 data: '@entity': in.co.sandbox.kyc.mca.company company_master_data: '@entity': in.co.sandbox.kyc.mca.company.master_data company_category: Company limited by Shares email_id: john@doe.com class_of_company: Private date_of_last_agm: 30/09/2019 registered_address: >- 123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 380015 IN registration_number: '999999' paid_up_capital(rs): '100000' whether_listed_or_not: Unlisted suspended_at_stock_exchange: '-' cin: U12345AB1234ABC123456 company_subcategory: Non-govt company authorised_capital(rs): '100000' company_status(for_efiling): Active roc_code: RoC-Ahmedabad date_of_balance_sheet: 31/03/2019 date_of_incorporation: 09/06/2017 company_name: JOHN DOE PRIVATE LIMITED active_compliance: ACTIVE Compliant rd_region: RD South East Region main_division_of_business_activity_to_be_carried_out_in_india: '72' previous_firm/_company_details,_if_applicable: '' number_of_designated_partners: '' total_obligation_of_contribution: '0' description_of_main_division: REAL ESTATE,RENTING AND BUSINESS ACTIVITIES number_of_partners: '' balance_sheets: [] annual_returns: [] charges: - '@entity': in.co.sandbox.kyc.mca.company.charges date_of_creation: 06/02/2019 date_of_modification: '-' charge_amount: '2000000000' status: Closed directors/signatory_details: - '@entity': >- in.co.sandbox.kyc.mca.company.directors_signatory_details end_date: '-' din/pan: '99999999' begin_date: 09/06/2017 designation: Director name: JOHN DOE 200 - Success (company) 2: summary: 200 - Success (company) 2 value: code: 200 timestamp: 1000000000000 transaction_id: 72bcf4e8-a809-4104-9396-e1fb5cfd8878 data: '@entity': in.co.sandbox.kyc.mca.company company_master_data: '@entity': in.co.sandbox.kyc.mca.company.master_data company_category: Company limited by Shares email_id: rahul@doe.com class_of_company: Private date_of_last_agm: 30/09/2019 registered_address: 15, ASHOK VIHAR, RAJOT, GUJARAT, 700001 registration_number: '999999' paid_up_capital(rs): '100000' whether_listed_or_not: Unlisted suspended_at_stock_exchange: '-' cin: U12345AB1234ABC456789 company_subcategory: Non-govt company authorised_capital(rs): '100000' company_status(for_efiling): Active roc_code: RoC-Rajkot date_of_balance_sheet: 31/03/2019 date_of_incorporation: 09/06/2017 company_name: RAHUL DOE PRIVATE LIMITED active_compliance: ACTIVE Compliant rd_region: RD South East Region main_division_of_business_activity_to_be_carried_out_in_india: '72' previous_firm/_company_details,_if_applicable: '' number_of_designated_partners: '' total_obligation_of_contribution: '0' description_of_main_division: REAL ESTATE,RENTING AND BUSINESS ACTIVITIES number_of_partners: '' balance_sheets: [] annual_returns: [] charges: - '@entity': in.co.sandbox.kyc.mca.company.charges date_of_creation: 06/02/2019 date_of_modification: '-' charge_amount: '2000000000' status: Closed directors/signatory_details: - '@entity': >- in.co.sandbox.kyc.mca.company.directors_signatory_details end_date: '-' din/pan: '99999999' begin_date: 09/06/2017 designation: Director name: JOHN DOE 200 - Success (company) 3: summary: 200 - Success (company) 3 value: code: 200 timestamp: 1000000000000 transaction_id: e4a174ec-fef1-434b-9225-0066af98a327 data: '@entity': in.co.sandbox.kyc.mca.company company_master_data: '@entity': in.co.sandbox.kyc.mca.company.master_data company_category: Company limited by Shares email_id: vikram@doe.com class_of_company: Private date_of_last_agm: 30/09/2019 registered_address: 30, RAJA GARDEN, BANGALORE, KARNATAKA, 560001 registration_number: '999999' paid_up_capital(rs): '100000' whether_listed_or_not: Unlisted suspended_at_stock_exchange: '-' cin: U12345AB1234ABC789789 company_subcategory: Non-govt company authorised_capital(rs): '100000' company_status(for_efiling): Active roc_code: RoC-Bangalore date_of_balance_sheet: 31/03/2019 date_of_incorporation: 09/06/2017 company_name: VIKRAM DOE PRIVATE LIMITED active_compliance: ACTIVE Compliant rd_region: RD South East Region main_division_of_business_activity_to_be_carried_out_in_india: '72' previous_firm/_company_details,_if_applicable: '' number_of_designated_partners: '' total_obligation_of_contribution: '0' description_of_main_division: REAL ESTATE,RENTING AND BUSINESS ACTIVITIES number_of_partners: '' balance_sheets: [] annual_returns: [] charges: - '@entity': in.co.sandbox.kyc.mca.company.charges date_of_creation: 06/02/2019 date_of_modification: '-' charge_amount: '2000000000' status: Closed directors/signatory_details: - '@entity': >- in.co.sandbox.kyc.mca.company.directors_signatory_details end_date: '-' din/pan: '99999999' begin_date: 09/06/2017 designation: Director name: JOHN DOE not found: summary: not found value: code: 422 timestamp: 1000000000000 transaction_id: ebf8a76d-093c-477a-8575-bca5b43ac0ab message: >- Entered CIN/LLPIN/FLLPIN/FCRN is not found. Please enter valid details. headers: {} deprecated: false security: [] ````