{
  "openapi": "3.0.1",
  "info": {
    "title": "Companies House Scraper - UK Company Data, Bulk Lookup, SIC",
    "description": "For KYB checks, B2B prospecting and credit teams: the whole official UK register, 5,689,367 companies in the 2026-09-01 snapshot, of which 5,171,600 are Active. Look up 50,000 company numbers per run or filter by SIC code, postcode, town and status. Official OGL data, no API key.",
    "version": "0.1",
    "x-build-id": "TFQikJfw1fDEZ8Mu9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/neverempty~companies-house-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-neverempty-companies-house-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/neverempty~companies-house-scraper/runs": {
      "post": {
        "operationId": "runs-sync-neverempty-companies-house-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/neverempty~companies-house-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-neverempty-companies-house-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": {
          "companyNumbers": {
            "title": "Company numbers to look up",
            "type": "array",
            "description": "Companies House registration numbers to look up in bulk, up to 50,000 per run, for example 00445790 (Tesco PLC), SC117120 or IP10067R. A number whose leading zeros were dropped by a spreadsheet (445790) is read as 00445790, and SC5336 as SC005336. When numbers are given, the search fields below are not used. The snapshot holds only live companies, so a dissolved company is reported as not in the snapshot (not charged).",
            "items": {
              "type": "string"
            }
          },
          "name": {
            "title": "Company name words",
            "type": "string",
            "description": "Words of the company name, for example octopus energy. Every word must start a word of the name (tesc finds TESCO), case and accents are ignored, and LTD / LIMITED are left out of the comparison."
          },
          "includePreviousNames": {
            "title": "Also match previous names",
            "type": "boolean",
            "description": "Also return companies whose former name (up to 10 kept in the register) matches the name words. The matching former name is in matchedPreviousName.",
            "default": false
          },
          "sicCodes": {
            "title": "SIC codes (industry)",
            "type": "array",
            "description": "SIC 2007 codes or their first digits, for example 62020 (IT consultancy), 6201 or 62 (all of division 62), 41202 or 43. A company matches when any of its SIC codes starts with one of these. Old 4-digit SIC 2003 codes that some companies still carry are returned in sicOtherText but are not matched.",
            "items": {
              "type": "string"
            }
          },
          "postcodes": {
            "title": "Registered office postcodes",
            "type": "array",
            "description": "Full postcodes (SW1A 1AA), sectors (SW1A 1), districts (EC1V, M1) or areas (M, EC). A district ending in a digit also takes its lettered sub-districts: EC1 means EC1A to EC1Y and SW1 means SW1A to SW1Y, but not SW10 to SW19. An area means exactly those letters: M is Manchester, not ME or MK.",
            "items": {
              "type": "string"
            }
          },
          "towns": {
            "title": "Post towns",
            "type": "array",
            "description": "Post towns of the registered office as written in the register, for example LONDON, MANCHESTER, HARLOW. Case is ignored, and a town written with a county (HARLOW, ESSEX) also matches HARLOW.",
            "items": {
              "type": "string"
            }
          },
          "companyStatuses": {
            "title": "Company status",
            "type": "array",
            "description": "Keep only these statuses. The snapshot holds only live companies, so every status here is a live one; dissolved companies are not in the data.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Active - Proposal to Strike off",
                "Liquidation",
                "In Administration",
                "Live but Receiver Manager on at least one charge",
                "Voluntary Arrangement",
                "In Administration/Administrative Receiver",
                "RECEIVERSHIP",
                "ADMINISTRATION ORDER",
                "ADMINISTRATIVE RECEIVER",
                "In Administration/Receiver Manager",
                "RECEIVER MANAGER / ADMINISTRATIVE RECEIVER",
                "VOLUNTARY ARRANGEMENT / RECEIVER MANAGER",
                "VOLUNTARY ARRANGEMENT / ADMINISTRATIVE RECEIVER"
              ]
            }
          },
          "companyTypes": {
            "title": "Company types",
            "type": "array",
            "description": "Keep only these company types, as Companies House writes them.",
            "items": {
              "type": "string",
              "enum": [
                "Private Limited Company",
                "PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)",
                "Limited Partnership",
                "Limited Liability Partnership",
                "Community Interest Company",
                "Charitable Incorporated Organisation",
                "PRI/LBG/NSC (Private, Limited by guarantee, no share capital, use of 'Limited' exemption)",
                "Overseas Entity",
                "Other company type",
                "Registered Society",
                "Scottish Charitable Incorporated Organisation",
                "Private Unlimited Company",
                "Public Limited Company",
                "Royal Charter Company",
                "Investment Company with Variable Capital",
                "United Kingdom Economic Interest Grouping",
                "Scottish Partnership",
                "Industrial and Provident Society",
                "Private Unlimited",
                "Investment Company with Variable Capital(Umbrella)",
                "Old Public Company",
                "PRIV LTD SECT. 30 (Private limited company, section 30 of the Companies Act)",
                "Investment Company with Variable Capital (Securities)",
                "United Kingdom Societas",
                "Protected Cell Company",
                "Other Company Type",
                "Further Education and Sixth Form College Corps",
                "Converted/Closed"
              ]
            }
          },
          "incorporatedFrom": {
            "title": "Incorporated on or after",
            "type": "string",
            "description": "Earliest incorporation date, written YYYY-MM-DD, for example 2026-08-01."
          },
          "incorporatedTo": {
            "title": "Incorporated on or before",
            "type": "string",
            "description": "Latest incorporation date, written YYYY-MM-DD."
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "name",
              "newest",
              "oldest"
            ],
            "type": "string",
            "description": "Name order is the order of the register and stops as soon as enough companies are found. Newest or oldest incorporated first reads the whole snapshot (3 to 6 minutes with the default memory) and then returns the first companies in that order.",
            "default": "name"
          },
          "maxResults": {
            "title": "Maximum companies (search)",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "The most companies a search returns, up to 50,000. Not used for company number lookups (every number found is returned).",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}