{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Registry Lookup: EU, UK & US (SEC EDGAR) + Officers",
    "description": "Look up companies in official registers across the EU, the UK (Companies House) and the US (SEC EDGAR), plus the global LEI index. Verify a business, check its EU VAT number live against VIES, and optionally return company officers with their job titles.",
    "version": "1.2",
    "x-build-id": "BKTznogy2nvDfrfMs"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pavel.tashev~european-company-registry-lookup/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pavel.tashev-european-company-registry-lookup",
        "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/pavel.tashev~european-company-registry-lookup/runs": {
      "post": {
        "operationId": "runs-sync-pavel.tashev-european-company-registry-lookup",
        "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/pavel.tashev~european-company-registry-lookup/run-sync": {
      "post": {
        "operationId": "run-sync-pavel.tashev-european-company-registry-lookup",
        "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",
        "required": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Companies",
            "maxItems": 1000,
            "type": "array",
            "description": "Company names, registration numbers or VAT numbers, one per line. Numbers are recognised automatically: French SIREN/SIRET, Norwegian organisasjonsnummer, Finnish Y-tunnus, Czech or Slovak IČO, Polish KRS number (e.g. KRS 0000019193), Irish CRO company number (e.g. CRO 249885), UK company number (e.g. UK 00445790 or SC090312), Latvian registration number, LEI codes, and EU VAT numbers such as CZ00177041 or BG831641791. Up to 1,000 companies per run; any extra entries are skipped and reported in the run status.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "verify"
            ],
            "type": "string",
            "description": "Search returns every matching company from each registry. Verify returns ONE consolidated answer per line: does this business exist, is it active, is its VAT number valid, and what is its LEI.",
            "default": "search"
          },
          "countries": {
            "title": "Countries and registries",
            "type": "array",
            "description": "Registries to search. Registration numbers are looked up in every selected registry whose format they match, so selecting fewer countries makes an ambiguous number unambiguous. Poland (KRS) supports lookups by registration number only. SEC EDGAR covers US public companies and other SEC filers, not private US companies - and name search there covers the ~10,500 companies that have a stock ticker; CIK lookup covers all filers.",
            "items": {
              "type": "string",
              "enum": [
                "FR",
                "NO",
                "FI",
                "CZ",
                "SK",
                "PL",
                "LV",
                "IE",
                "UK",
                "SEC",
                "LEI"
              ],
              "enumTitles": [
                "France (Sirene)",
                "Norway (Brønnøysund)",
                "Finland (YTJ / PRH)",
                "Czech Republic (ARES)",
                "Slovakia (RPO)",
                "Poland (KRS, number lookup only)",
                "Latvia (Register of Enterprises)",
                "Ireland (CRO)",
                "United Kingdom (Companies House, needs an API key)",
                "United States (SEC EDGAR, public companies only)",
                "Global LEI index (GLEIF)"
              ]
            },
            "default": [
              "FR",
              "NO",
              "FI",
              "CZ",
              "SK",
              "PL",
              "LV",
              "IE",
              "UK",
              "SEC",
              "LEI"
            ]
          },
          "lookupMode": {
            "title": "Lookup mode",
            "enum": [
              "auto",
              "name",
              "id"
            ],
            "type": "string",
            "description": "Auto treats valid registration numbers as numbers and everything else as a company name. Name only and Number only force one kind of lookup.",
            "default": "auto"
          },
          "maxResultsPerQuery": {
            "title": "Maximum results per company and registry",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "For name searches: how many matching companies to return from each registry, best matches first (1-50). Every word of the name must appear in the company name. If a search returns more than 50 matches, the name is too general - add the legal form or the town.",
            "default": 10
          },
          "includeRaw": {
            "title": "Include original registry record",
            "type": "boolean",
            "description": "Adds the registry's original record under `raw` (without person data such as directors). Makes the dataset much larger.",
            "default": false
          },
          "includeVat": {
            "title": "Check VAT numbers (VIES)",
            "type": "boolean",
            "description": "In Verify mode, check EU VAT numbers against the European Commission's VIES service. Norwegian and UK numbers are not covered by VIES.",
            "default": true
          },
          "includeLei": {
            "title": "Look up LEI and parent company",
            "type": "boolean",
            "description": "In Verify mode, find the company's LEI code in the GLEIF index and report its direct and ultimate parent company when one is registered.",
            "default": true
          },
          "includeEuContracts": {
            "title": "Check EU public contracts (TED)",
            "type": "boolean",
            "description": "Also look up EU public contract awards this company won, from TED (Tenders Electronic Daily). Matches on the registration or VAT number TED lists as the tenderer; if none matches, it falls back to the company name and labels the result as candidates rather than fact. Adds about one second per company and costs nothing extra.",
            "default": false
          },
          "maxContracts": {
            "title": "Maximum EU contract awards per company",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many award notices to return per company. The total number found is always reported, even when more were found than returned.",
            "default": 10
          },
          "companyStatus": {
            "title": "Company status",
            "type": "array",
            "description": "Keep only companies with these statuses. Applies to search, not to verifying a named company.",
            "items": {
              "type": "string",
              "enum": [
                "active",
                "inactive",
                "dissolved"
              ],
              "enumTitles": [
                "Active",
                "Inactive (for example liquidation in progress)",
                "Dissolved"
              ]
            },
            "default": []
          },
          "incorporatedAfter": {
            "title": "Incorporated after",
            "type": "string",
            "description": "Keep only companies registered on or after this date (YYYY-MM-DD). Companies from registers that publish no incorporation date are kept, since dropping them would hide whole countries."
          },
          "incorporatedBefore": {
            "title": "Incorporated before",
            "type": "string",
            "description": "Keep only companies registered on or before this date (YYYY-MM-DD)."
          },
          "industryCodes": {
            "title": "Industry codes",
            "type": "string",
            "description": "Comma-separated activity codes, for example \"62, 63.11\". A code matches longer codes beneath it, so 62 finds 62.01 — activity codes are hierarchical."
          },
          "nameContains": {
            "title": "Name contains",
            "type": "string",
            "description": "Keep only companies whose registered name contains any of these, comma separated."
          },
          "nameExcludes": {
            "title": "Name excludes",
            "type": "string",
            "description": "Drop companies whose registered name contains any of these."
          },
          "watch": {
            "title": "Watch these companies for changes",
            "type": "boolean",
            "description": "Remembers each company’s name, status, address, legal form, activity codes, VAT and LEI, and reports in \"changedFields\" what differs from the previous run.",
            "default": false
          },
          "onlyChanged": {
            "title": "Only save companies that changed",
            "type": "boolean",
            "description": "Turns the watchlist into a monitor: a company whose watched details are unchanged is not saved and not charged. A company seen for the first time is always saved.",
            "default": false
          },
          "watchlistName": {
            "title": "Watchlist name",
            "type": "string",
            "description": "Keep separate watchlists for separate sets of companies.",
            "default": "default"
          },
          "includeFilingHistory": {
            "title": "Include UK filing history",
            "type": "boolean",
            "description": "For UK companies, also fetch what the company has filed at Companies House — accounts, confirmation statements, charges and insolvency — with dates. One extra request per company. Directors’ and officers’ names are never included.",
            "default": false
          },
          "maxFilings": {
            "title": "Maximum filings per company",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many of the most recent filings to return. The summary still counts every filing Companies House reports, not only the ones returned.",
            "default": 50
          },
          "includeOfficers": {
            "title": "Include company officers (personal data)",
            "type": "boolean",
            "description": "Return the people the register names as running each company: directors, secretaries and equivalent. Available for the United Kingdom, France and the United States (SEC EDGAR). This is personal data - you need your own lawful basis for processing it. US officers come from the company's insider-trading filings (Forms 3/4/5), so they carry real job titles but are not a complete board, and a company with no recent filing returns none.",
            "default": false
          },
          "officerAddresses": {
            "title": "Include officer addresses",
            "type": "boolean",
            "description": "Off by default and deliberately so — a register’s service address is often a person’s home. Turn it on only if your check genuinely needs it.",
            "default": false
          },
          "includeResignedOfficers": {
            "title": "Include former officers",
            "type": "boolean",
            "description": "Off by default: someone who resigned years ago is rarely relevant to a check on the company today.",
            "default": false
          },
          "maxOfficers": {
            "title": "Maximum officers per company",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "The summary still counts every officer the register reports, not only those returned.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}