{
  "openapi": "3.0.1",
  "info": {
    "title": "UK Companies House New Company Finder (Leads by SIC & Date)",
    "description": "Find newly incorporated UK companies from the official Companies House API: filter by incorporation date, SIC code, status, type, location and postcode. Company-level data with SIC descriptions, registered office, accounts due dates. Schedule daily for fresh B2B leads.",
    "version": "0.1",
    "x-build-id": "oxbC9BrAsOhb7PwW4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lindenbyte~uk-companies-house-new-companies/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lindenbyte-uk-companies-house-new-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/lindenbyte~uk-companies-house-new-companies/runs": {
      "post": {
        "operationId": "runs-sync-lindenbyte-uk-companies-house-new-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/lindenbyte~uk-companies-house-new-companies/run-sync": {
      "post": {
        "operationId": "run-sync-lindenbyte-uk-companies-house-new-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": {
          "incorporatedLastDays": {
            "title": "Incorporated in the last N days",
            "minimum": 1,
            "maximum": 3660,
            "type": "integer",
            "description": "Rolling window for schedules: 1 = today only (UK time), 7 = the last 7 days including today. Overrides the from/to dates. Leave empty to use the dates below; if everything is empty the last 7 days are used. Companies House can take a day to index new companies, so for a daily schedule use 2 and let duplicates go (or dedupe downstream)."
          },
          "incorporatedFrom": {
            "title": "Incorporated from (YYYY-MM-DD)",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "First incorporation date, inclusive, e.g. 2026-11-01. Used only when 'last N days' is empty."
          },
          "incorporatedTo": {
            "title": "Incorporated to (YYYY-MM-DD)",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Last incorporation date, inclusive. Empty = today."
          },
          "sicCodes": {
            "title": "SIC codes",
            "type": "array",
            "description": "UK SIC 2007 5-digit codes, e.g. 62012 (software development), 56101 (restaurants), 68100 (buying and selling own real estate), 70229 (management consultancy). Empty = all industries. A company matches if it has any of the codes.",
            "items": {
              "type": "string"
            }
          },
          "companyStatus": {
            "title": "Company status",
            "type": "array",
            "description": "Status filter. New companies are almost always 'active'. Empty = any status.",
            "items": {
              "type": "string",
              "enum": [
                "active",
                "dissolved",
                "open",
                "closed",
                "converted-closed",
                "receivership",
                "administration",
                "liquidation",
                "insolvency-proceedings",
                "voluntary-arrangement",
                "registered",
                "removed"
              ],
              "enumTitles": [
                "Active",
                "Dissolved",
                "Open",
                "Closed",
                "Converted / Closed",
                "Receiver Action",
                "In Administration",
                "Liquidation",
                "Insolvency Proceedings",
                "Voluntary Arrangement",
                "Registered",
                "Removed"
              ]
            },
            "default": [
              "active"
            ]
          },
          "companyType": {
            "title": "Company type",
            "type": "array",
            "description": "E.g. 'ltd' (private limited company), 'llp', 'plc'. Empty = all types.",
            "items": {
              "type": "string",
              "enum": [
                "private-unlimited",
                "ltd",
                "plc",
                "old-public-company",
                "private-limited-guarant-nsc-limited-exemption",
                "limited-partnership",
                "private-limited-guarant-nsc",
                "converted-or-closed",
                "private-unlimited-nsc",
                "private-limited-shares-section-30-exemption",
                "protected-cell-company",
                "assurance-company",
                "oversea-company",
                "eeig",
                "icvc-securities",
                "icvc-warrant",
                "icvc-umbrella",
                "registered-society-non-jurisdictional",
                "industrial-and-provident-society",
                "northern-ireland",
                "northern-ireland-other",
                "royal-charter",
                "investment-company-with-variable-capital",
                "unregistered-company",
                "llp",
                "other",
                "european-public-limited-liability-company-se",
                "uk-establishment",
                "scottish-partnership",
                "charitable-incorporated-organisation",
                "scottish-charitable-incorporated-organisation",
                "further-education-or-sixth-form-college-corporation",
                "registered-overseas-entity"
              ],
              "enumTitles": [
                "Private unlimited company",
                "Private limited company",
                "Public limited company",
                "Old public company",
                "Private Limited Company by guarantee without share capital, use of 'Limited' exemption",
                "Limited partnership",
                "Private limited by guarantee without share capital",
                "Converted / closed",
                "Private unlimited company without share capital",
                "Private Limited Company, use of 'Limited' exemption",
                "Protected cell company",
                "Assurance company",
                "Overseas company",
                "European Economic Interest Grouping (EEIG)",
                "Investment company with variable capital",
                "Investment company with variable capital",
                "Investment company with variable capital",
                "Registered society",
                "Industrial and Provident society",
                "Northern Ireland company",
                "Credit union (Northern Ireland)",
                "Royal charter company",
                "Investment company with variable capital",
                "Unregistered company",
                "Limited liability partnership",
                "Other company type",
                "European public limited liability company (SE)",
                "UK establishment company",
                "Scottish qualifying partnership",
                "Charitable incorporated organisation",
                "Scottish charitable incorporated organisation",
                "Further education or sixth form college corporation",
                "Overseas entity"
              ]
            }
          },
          "companySubtype": {
            "title": "Company subtype",
            "type": "array",
            "description": "Optional: only Community Interest Companies or Private Fund Limited Partnerships.",
            "items": {
              "type": "string",
              "enum": [
                "community-interest-company",
                "private-fund-limited-partnership"
              ],
              "enumTitles": [
                "Community Interest Company (CIC)",
                "Private Fund Limited Partnership (PFLP)"
              ]
            }
          },
          "location": {
            "title": "Location (Companies House filter)",
            "type": "string",
            "description": "Free-text location matched by Companies House against the registered office address, e.g. Manchester or Leeds."
          },
          "postcodePrefixes": {
            "title": "Postcode prefixes",
            "type": "array",
            "description": "Keep only registered offices in these postcode areas/districts, e.g. M (Manchester area), SW1 (SW1A..SW1Y, not SW10), EC1V, BS8 1. Filtered after the search, so it scans more results; filtered-out companies are not charged.",
            "items": {
              "type": "string"
            }
          },
          "nameIncludes": {
            "title": "Company name includes",
            "type": "string",
            "description": "Only companies whose name contains this text, e.g. CONSULTING."
          },
          "nameExcludes": {
            "title": "Company name excludes",
            "type": "string",
            "description": "Drop companies whose name contains this text, e.g. HOLDINGS."
          },
          "excludeDormant": {
            "title": "Exclude dormant / non-trading",
            "type": "boolean",
            "description": "Drop companies registered with SIC 99999 (Dormant Company) or 74990 (Non-trading company). Not charged.",
            "default": false
          },
          "maxResults": {
            "title": "Max companies",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many companies are saved. Each saved company is one charged result.",
            "default": 1000
          },
          "includeProfile": {
            "title": "Add company profile (accounts and confirmation statement due dates)",
            "type": "boolean",
            "description": "One extra API call per company: next accounts due date and period, last accounts type, accounting reference date, confirmation statement due date, overdue flags, charges/insolvency flags, previous names, full registered office address. Charged as an extra 'company profile' event only when it succeeds.",
            "default": false
          },
          "includeOfficerPscCounts": {
            "title": "Add officer and PSC counts",
            "type": "boolean",
            "description": "Two extra API calls per company: number of active/resigned officers and active/ceased persons with significant control. Counts only: no names, birth dates or addresses of people are collected. Charged as an extra event only when it succeeds.",
            "default": false
          },
          "apiKey": {
            "title": "Companies House API key (optional)",
            "type": "string",
            "description": "Your own free Companies House REST API key (600 requests per 5 minutes). Leave empty to use the Actor's built-in key, which is shared by all users and can be slower at busy times. Get one: https://developer.company-information.service.gov.uk/get-started"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}