{
  "openapi": "3.0.1",
  "info": {
    "title": "🇮🇳 India MCA Companies — CIN & Director Lookup",
    "description": "Search India MCA21 registry by name / CIN / entity type / status / state. Returns CIN, entity type, status, registered office, ROC, directors, paid-up & authorized capital INR, NSE/BSE listing. KYC, AML, M&A — Bloomberg/BVD Orbis/Refinitiv/Tofler/Zauba alt.",
    "version": "0.0",
    "x-build-id": "EqPN7W2IJJwbTHdCU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nexgendata~india-mca-companies/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nexgendata-india-mca-companies",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/nexgendata~india-mca-companies/runs": {
      "post": {
        "operationId": "runs-sync-nexgendata-india-mca-companies",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/nexgendata~india-mca-companies/run-sync": {
      "post": {
        "operationId": "run-sync-nexgendata-india-mca-companies",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "search_query": {
            "title": "Company name / keyword (partial match)",
            "type": "string",
            "description": "Partial-match company-name search. Searches India's Ministry of Corporate Affairs (MCA21) registry plus aggregated public lists (NSE/BSE-listed companies and India's largest privately-held unicorns). Case-insensitive substring match against the registered legal name. Leave empty to retrieve the full curated universe filtered by the other fields. Example: 'Reliance', 'Tata', 'Infosys', 'Flipkart', 'Adani', 'HDFC'."
          },
          "cin": {
            "title": "CIN — Corporate Identification Number (exact match)",
            "type": "string",
            "description": "India's Corporate Identification Number — the 21-character canonical MCA-issued identifier for every company registered under the Companies Act 2013 (and predecessor Companies Act 1956). Format: L/U + 5-digit industry code + 2-letter state code + 4-digit year + 3-letter type code + 6-digit registration number (e.g. 'L17110MH1973PLC019786' for Reliance Industries Ltd, 'L85110KA1981PLC013115' for Infosys Ltd). Exact match. Takes precedence over search_query when both are provided."
          },
          "entity_type": {
            "title": "Entity type",
            "enum": [
              "ALL",
              "PUBLIC_LIMITED",
              "PRIVATE_LIMITED",
              "OPC",
              "LLP",
              "SECTION_8",
              "FOREIGN"
            ],
            "type": "string",
            "description": "Filter by MCA entity type. 'ALL' returns everything. 'PUBLIC_LIMITED' covers companies whose CIN starts with 'L' — listed and unlisted public limited companies (the dominant form for NSE/BSE-listed firms). 'PRIVATE_LIMITED' covers companies whose CIN starts with 'U' and have 'PTC' / 'PRT' in the type code — the dominant form for Indian startups, family businesses, and SME entities. 'OPC' covers One Person Companies introduced under Section 2(62) of the Companies Act 2013. 'LLP' covers Limited Liability Partnerships registered under the LLP Act 2008 (LLPIN format, not CIN). 'SECTION_8' covers non-profits under Section 8 of the Companies Act 2013 (formerly Section 25 under the 1956 Act).",
            "default": "ALL"
          },
          "status": {
            "title": "Registry status",
            "enum": [
              "ALL",
              "ACTIVE",
              "STRIKE_OFF",
              "UNDER_LIQUIDATION",
              "DORMANT",
              "AMALGAMATED",
              "CONVERTED"
            ],
            "type": "string",
            "description": "Filter by MCA registry status. 'ACTIVE' = currently active and compliant with annual filings. 'STRIKE_OFF' = struck off the register under Section 248 of the Companies Act 2013 (typically for non-filing of annual returns). 'UNDER_LIQUIDATION' = currently in liquidation under the Insolvency and Bankruptcy Code 2016 (IBC) or the Companies Act provisions. 'DORMANT' = registered but inactive under Section 455 of the Companies Act 2013. 'AMALGAMATED' = merged into another entity via a National Company Law Tribunal (NCLT) order. 'CONVERTED' = converted to a different entity type (e.g. private to public). 'ALL' returns every status.",
            "default": "ACTIVE"
          },
          "state": {
            "title": "Registered office state (2-letter MCA code)",
            "type": "string",
            "description": "Filter by registered-office state (the 2-letter MCA state code embedded in positions 7-8 of the CIN). Common codes: 'MH' = Maharashtra (Mumbai — financial capital, most NSE/BSE issuers), 'KA' = Karnataka (Bengaluru — IT/startup capital), 'DL' = Delhi (capital, conglomerate HQs), 'GJ' = Gujarat (industrial / Adani), 'TN' = Tamil Nadu (Chennai — autos / IT), 'TG' = Telangana (Hyderabad — IT / pharma), 'UP' = Uttar Pradesh, 'WB' = West Bengal (Kolkata), 'HR' = Haryana (Gurugram — startups), 'RJ' = Rajasthan, 'AP' = Andhra Pradesh, 'KL' = Kerala. Leave empty for nationwide."
          },
          "listed_only": {
            "title": "Only NSE / BSE-listed companies",
            "type": "boolean",
            "description": "When true, restricts results to companies actively listed on India's National Stock Exchange (NSE) and/or Bombay Stock Exchange (BSE). These companies have CIN prefix 'L' AND are confirmed listed on at least one exchange. Useful when cross-referencing MCA filings against NSE/BSE ticker symbols for buy-side equity research, sell-side coverage, or index-construction workflows.",
            "default": false
          },
          "limit": {
            "title": "Max companies returned",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Hard cap on total companies returned in this run (1-2000). Each company is one dataset row. Premium pricing applies per row ($0.10/company).",
            "default": 50
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}