{
  "openapi": "3.0.1",
  "info": {
    "title": "India Company Data & New-Company Discovery (MCA)",
    "description": "Search India's MCA register by name, CIN, industry, and location, and discover newly incorporated companies by date. Get status, type, capital, corrected industry, location, the company's public email, and the public board of directors. Privacy-safe and PII-free.",
    "version": "1.0",
    "x-build-id": "F5cH3jwAIcR8Fwdbf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/factden~mca-company-director-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-factden-mca-company-director-scraper",
        "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/factden~mca-company-director-scraper/runs": {
      "post": {
        "operationId": "runs-sync-factden-mca-company-director-scraper",
        "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/factden~mca-company-director-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-factden-mca-company-director-scraper",
        "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": {
          "companyNames": {
            "title": "🏷️ Company names",
            "uniqueItems": true,
            "type": "array",
            "description": "Search by company name. Whole-word, typo-tolerant match on the registered name — word order does not matter and minor misspellings still resolve. Add an industry or location below to narrow.",
            "items": {
              "type": "string"
            }
          },
          "cins": {
            "title": "🏢 CINs",
            "uniqueItems": true,
            "type": "array",
            "description": "Exact CINs, e.g. U63999MH2024PTC431654 — a direct lookup that returns that company as recorded. The filters below are ignored for pasted CINs.",
            "items": {
              "type": "string"
            }
          },
          "industry": {
            "title": "🏭 Industry",
            "type": "array",
            "description": "Find companies by industry, using our corrected classification (not the raw NIC code). Pick one or more of the 16 industry groups.",
            "items": {
              "type": "string",
              "enum": [
                "agriculture",
                "business_support",
                "construction",
                "education",
                "energy_utilities",
                "financial_services",
                "healthcare",
                "hospitality_food",
                "logistics_transport",
                "manufacturing",
                "media_telecom",
                "other",
                "professional_services",
                "real_estate",
                "retail_trading",
                "technology_it"
              ],
              "enumTitles": [
                "Agriculture & Allied",
                "Business Support Services",
                "Construction & Infrastructure",
                "Education & Training",
                "Energy & Utilities",
                "Financial Services",
                "Healthcare & Social Work",
                "Hospitality & Food Services",
                "Logistics & Transport",
                "Manufacturing",
                "Media, Publishing & Telecom",
                "Other (Mining, Arts & Personal Services)",
                "Professional Services",
                "Real Estate",
                "Retail & Wholesale Trade",
                "Technology & IT"
              ]
            },
            "default": []
          },
          "states": {
            "title": "📍 States / UTs",
            "type": "array",
            "description": "Keep only companies in these states or union territories. Narrows a name or industry search; not a search on its own.",
            "items": {
              "type": "string",
              "enum": [
                "Andaman & Nicobar Islands",
                "Andhra Pradesh",
                "Arunachal Pradesh",
                "Assam",
                "Bihar",
                "Chandigarh",
                "Chhattisgarh",
                "Dadra & Nagar Haveli",
                "Daman & Diu",
                "Delhi",
                "Goa",
                "Gujarat",
                "Haryana",
                "Himachal Pradesh",
                "Jammu & Kashmir",
                "Jharkhand",
                "Karnataka",
                "Kerala",
                "Ladakh",
                "Lakshadweep",
                "Madhya Pradesh",
                "Maharashtra",
                "Manipur",
                "Meghalaya",
                "Mizoram",
                "Nagaland",
                "Odisha",
                "Puducherry",
                "Punjab",
                "Rajasthan",
                "Sikkim",
                "Tamil Nadu",
                "Telangana",
                "Tripura",
                "Uttar Pradesh",
                "Uttarakhand",
                "West Bengal"
              ]
            },
            "default": []
          },
          "cities": {
            "title": "🏙️ Cities",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only companies in these cities. Input-tolerant — e.g. 'Bangalore' and 'Bengaluru' resolve to the same place.",
            "items": {
              "type": "string"
            }
          },
          "companyStatuses": {
            "title": "🟢 Company status",
            "type": "array",
            "description": "Keep only companies with these statuses. Default is Active only. Clear it to include struck-off, amalgamated, dormant and the rest.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Strike Off",
                "Under process of striking off",
                "Amalgamated",
                "Dissolved",
                "Dissolved (Liquidated)",
                "Dormant under section 455",
                "Converted to LLP",
                "Inactive for e-filing",
                "Under CIRP",
                "Under Liquidation"
              ]
            },
            "default": [
              "Active"
            ]
          },
          "incorporatedAfter": {
            "title": "🆕 Incorporated on/after (paid plans only)",
            "type": "string",
            "description": "NEW-COMPANY DISCOVERY — find companies incorporated on or after this date. Paid plans only: on the free plan this filter is ignored and companies from the last 3 months are excluded."
          },
          "incorporatedBefore": {
            "title": "📅 Incorporated on/before",
            "type": "string",
            "description": "Find companies incorporated on or before this date."
          },
          "includeDirectors": {
            "title": "📋 Include board of directors (public, free)",
            "type": "boolean",
            "description": "Return each company's board as public-record rows: name, DIN, designation. No personal contact details. Free, included with the company.",
            "default": true
          },
          "maxCompanies": {
            "title": "🔢 Max companies",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap on companies returned per run. Free plan is limited to 10 per run.",
            "default": 100
          },
          "subIndustry": {
            "title": "🏭 Sub-industry (NIC group codes)",
            "uniqueItems": true,
            "type": "array",
            "description": "Advanced: narrow to specific 3-digit NIC-2008 group codes (e.g. 620) for finer industry targeting.",
            "items": {
              "type": "string"
            }
          },
          "activity": {
            "title": "🏭 Activity (NIC class codes)",
            "uniqueItems": true,
            "type": "array",
            "description": "Advanced: narrow to specific 4-digit NIC-2008 class codes (e.g. 6201).",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}