{
  "openapi": "3.0.1",
  "info": {
    "title": "UK Company Accounts Data — Companies House Accounts, Net Assets",
    "description": "Companies House accounts as company data, no API key: net assets, cash, creditors, employees, dormant flag and accounts type for every set of accounts filed (daily iXBRL files); turnover and profit when filed. No directors. Unofficial: not affiliated with or endorsed by Companies House.",
    "version": "0.4",
    "x-build-id": "9sHuCOKeb3KLbE4Z9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rein8~uk-company-financials/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rein8-uk-company-financials",
        "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/rein8~uk-company-financials/runs": {
      "post": {
        "operationId": "runs-sync-rein8-uk-company-financials",
        "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/rein8~uk-company-financials/run-sync": {
      "post": {
        "operationId": "run-sync-rein8-uk-company-financials",
        "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": {
          "date": {
            "title": "Daily file (one day)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "The date of one daily file, YYYY-MM-DD (e.g. 2026-09-26). Empty = the newest file on the download page. Files are published Tuesday to Saturday and kept for 60 days; a date with no file stops the run before anything is charged."
          },
          "dateFrom": {
            "title": "From date",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "First day of a window of daily files, YYYY-MM-DD (e.g. a week: 2026-09-20). Every file from this date to \"To date\" is read, oldest first, one scan fee per file, at most 31 files. Ignored when \"Daily file\" is set."
          },
          "dateTo": {
            "title": "To date",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Last day of the window, YYYY-MM-DD. Empty with \"From date\" set = up to the newest file."
          },
          "companyNumbers": {
            "title": "Only these company numbers",
            "type": "string",
            "description": "Company numbers, one per line or separated by commas, tabs or spaces. Leading zeros are optional: 445790 = 00445790, SC12345 = SC012345. A number pasted next to its company name is read too (the name is ignored). Only the accounts registered in the chosen day(s) come back: a company that did not file in that window is simply absent. Combine with a date window (up to 60 days back) to check a customer list."
          },
          "minNetAssets": {
            "title": "Net assets at least",
            "type": "integer",
            "description": "Minimum net assets (shareholders' funds) in the filing's currency, e.g. 100000. Reported by 98% of filings, micro-entities included. Negative values are allowed."
          },
          "maxNetAssets": {
            "title": "Net assets at most",
            "type": "integer",
            "description": "Maximum net assets. Set -1 to keep only companies whose liabilities exceed their assets (negative net assets: about 1 in 5 daily filings), the classic credit-risk signal."
          },
          "minCash": {
            "title": "Cash at least",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum cash at bank and in hand, e.g. 250000. Reported by about half of daily filings (micro-entity balance sheets often show current assets only): rows without a cash figure never match."
          },
          "minEmployees": {
            "title": "Employees at least",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum average number of employees during the period (reported by 9 in 10 filings, including micro-entities), e.g. 50."
          },
          "minTurnover": {
            "title": "Turnover at least",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum turnover in the filing's currency (usually GBP), e.g. 1000000 for £1m+. Only accounts that report turnover can match — about 2% of a day's filings (the larger companies filing full FRS 102 / IFRS accounts); micro-entity, filleted and abridged accounts file no profit and loss account."
          },
          "maxTurnover": {
            "title": "Turnover at most",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum turnover, e.g. 10000000 for companies up to £10m. Rows without a turnover figure never match (see \"Turnover at least\")."
          },
          "accountsStandard": {
            "title": "Accounts standard",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only accounts prepared under these standards. Empty = all. Measured on a day's file: micro-entity 42%, small 30%, FRS 102 27%, medium / FRS 101 / IFRS under 1%. Micro-entity and small accounts carry a balance sheet and employees; full FRS 102 / IFRS accounts are the ones with turnover and profit.",
            "items": {
              "type": "string",
              "enum": [
                "micro-entity",
                "small",
                "medium",
                "FRS 102",
                "FRS 101",
                "IFRS",
                "charity"
              ],
              "enumTitles": [
                "Micro-entity (FRS 105: balance sheet only)",
                "Small entity (FRS 102 section 1A)",
                "Medium entity",
                "FRS 102 (full)",
                "FRS 101",
                "IFRS",
                "Charity SORP"
              ]
            }
          },
          "accountsType": {
            "title": "Accounts type",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only these filing types. Empty = all. Measured on a day's file: full 63%, filleted 32%, abridged 5%. \"Filleted\" = a small company that chose not to file its profit and loss account; \"abridged\" = a summarised balance sheet. Dormant companies are not a type: use \"Only dormant companies\".",
            "items": {
              "type": "string",
              "enum": [
                "full",
                "filleted",
                "abridged"
              ],
              "enumTitles": [
                "Full accounts",
                "Filleted accounts (no profit and loss)",
                "Abridged accounts"
              ]
            }
          },
          "excludeDormant": {
            "title": "Leave dormant companies out",
            "type": "boolean",
            "description": "On: filings that declare the company dormant are dropped (about 1 in 8 daily filings). A filing that does not say either way is kept.",
            "default": false
          },
          "onlyDormant": {
            "title": "Only dormant companies",
            "type": "boolean",
            "description": "On: only filings that declare the company dormant (about 1 in 8 daily filings) — accountants, strike-off and company-formation services. Off: no restriction.",
            "default": false
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum rows per run (one row per company and accounting period). A daily file holds about 17,000 filings; 1,000 covers a filtered day, 20,000 a whole one. The read stops as soon as the limit is reached.",
            "default": 1000
          },
          "incremental": {
            "title": "Only rows not delivered before",
            "type": "boolean",
            "description": "Off (default): every matching filing in the chosen day(s). On (for a schedule saved as a Task): rows already delivered under this memory are skipped; a re-filed (amended) set of accounts for the same period comes back as a changed row marked _changed only when a figure differs. A daily file that has not changed since the last run is not downloaded again.",
            "default": false
          },
          "stateKey": {
            "title": "Memory name",
            "type": "string",
            "description": "The memory an incremental run uses to remember what it delivered. Left as \"default\", every saved Task gets its own memory automatically (a run started by hand remembers per filter set). Type a name to share one memory between Tasks on purpose.",
            "default": "default"
          },
          "allowStateFallback": {
            "title": "Run without memory if the memory cannot be opened",
            "type": "boolean",
            "description": "Only matters if an incremental run stops with \"state store unavailable\". Off (default): such a run stops before anything is charged. On: the run continues without memory, i.e. it delivers and charges everything again.",
            "default": false
          },
          "preview": {
            "title": "Preview (5 companies, free)",
            "type": "boolean",
            "description": "Return 5 filings without any charge, to check the format. A preview does not touch the memory.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}