{
  "openapi": "3.0.1",
  "info": {
    "title": "UK Company Financials – Turnover, Profit, Net Assets",
    "description": "Turnover, profit, net assets, cash, debt and employees for UK companies from their filed annual accounts, with prior year. Look up company numbers or screen by SIC, postcode and size. No API key.",
    "version": "0.1",
    "x-build-id": "QD1A8Px90Nfw4dVZf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/stimulating_stilbite~uk-company-financials/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-stimulating_stilbite-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/stimulating_stilbite~uk-company-financials/runs": {
      "post": {
        "operationId": "runs-sync-stimulating_stilbite-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/stimulating_stilbite~uk-company-financials/run-sync": {
      "post": {
        "operationId": "run-sync-stimulating_stilbite-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": {
          "companyNumbers": {
            "title": "Company numbers",
            "type": "array",
            "description": "UK company registration numbers (8 characters, e.g. 00445790, SC123456; leading zeros optional). Returns the latest filed accounts for each. Leave empty to screen with the filters below.",
            "items": {
              "type": "string"
            }
          },
          "sicCodes": {
            "title": "SIC codes",
            "type": "array",
            "description": "SIC 2007 codes (62012), prefixes (62, 620) or section letters (J = information & communication, F = construction, C = manufacturing, M = professional services). Any of them.",
            "items": {
              "type": "string"
            }
          },
          "postcodePrefixes": {
            "title": "Postcode area / prefix",
            "type": "array",
            "description": "Registered-office postcode. Letters only = exact area (M = Manchester, not ME/ML; B = Birmingham; EH = Edinburgh). With digits = prefix (EC1, SW1A, LS1).",
            "items": {
              "type": "string"
            }
          },
          "postTowns": {
            "title": "Post towns",
            "type": "array",
            "description": "Registered-office post town contains, e.g. LEEDS, BRISTOL.",
            "items": {
              "type": "string"
            }
          },
          "nameKeywords": {
            "title": "Name contains",
            "type": "array",
            "description": "Company name contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "minTurnover": {
            "title": "Min turnover (£)",
            "type": "integer",
            "description": "Only companies whose latest accounts report turnover ≥ this. Note: most small and micro companies don't file a profit & loss account, so turnover filters return mainly medium/large companies."
          },
          "maxTurnover": {
            "title": "Max turnover (£)",
            "type": "integer",
            "description": "Upper turnover limit."
          },
          "minNetAssets": {
            "title": "Min net assets (£)",
            "type": "integer",
            "description": "Net assets / shareholders' funds ≥ this (available for almost every filer). Negative values allowed."
          },
          "minEmployees": {
            "title": "Min average employees",
            "type": "integer",
            "description": "Average number of employees in the period ≥ this."
          },
          "maxEmployees": {
            "title": "Max average employees",
            "type": "integer",
            "description": "Average number of employees ≤ this."
          },
          "minProfit": {
            "title": "Min profit before tax (£)",
            "type": "integer",
            "description": "Profit before tax (or after tax if before-tax isn't filed) ≥ this. Use 0 for profitable companies only."
          },
          "onlyWithTurnover": {
            "title": "Only companies that report turnover",
            "type": "boolean",
            "description": "Skip filers without a profit & loss account (micro-entity / filleted accounts).",
            "default": false
          },
          "periodEndFrom": {
            "title": "Accounts period ending on/after",
            "type": "string",
            "description": "YYYY-MM-DD. E.g. 2025-06-30 for fresh accounts only."
          },
          "statuses": {
            "title": "Company status",
            "type": "array",
            "description": "Default: Active only (ignored for company-number lookups).",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Active - Proposal to Strike off",
                "Liquidation",
                "In Administration",
                "Voluntary Arrangement",
                "Live but Receiver Manager on at least one charge"
              ]
            },
            "default": [
              "Active"
            ]
          },
          "excludeDormant": {
            "title": "Exclude dormant companies",
            "type": "boolean",
            "description": "Drop companies whose accounts say they're dormant.",
            "default": true
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "turnover",
              "netAssets",
              "employees",
              "profit",
              "profitAfterTax",
              "cash",
              "turnoverGrowth",
              "periodEnd"
            ],
            "type": "string",
            "description": "Largest first.",
            "default": "turnover"
          },
          "maxItems": {
            "title": "Max companies",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum rows returned (the biggest matches by the sort field).",
            "default": 100
          },
          "buildIndex": {
            "title": "Rebuild index (owner only)",
            "type": "boolean",
            "description": "Internal: monthly index refresh by the actor owner. Leave off.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}