{
  "openapi": "3.0.1",
  "info": {
    "title": "European Company Registry API: France, Norway, Finland +3",
    "description": "European company registry API for six official registers: France (Sirene), Norway (Brønnøysund), Finland (PRH/YTJ), the Irish company register (CRO), Czechia (ARES) and Poland (KRS). EU and Norway company data in one schema: lookup in all six, name search in five, new companies in three. No API key.",
    "version": "0.1",
    "x-build-id": "ValZCebLoJXVqY8Xc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/yourevenings~eu-company-registers/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-yourevenings-eu-company-registers",
        "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/yourevenings~eu-company-registers/runs": {
      "post": {
        "operationId": "runs-sync-yourevenings-eu-company-registers",
        "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/yourevenings~eu-company-registers/run-sync": {
      "post": {
        "operationId": "run-sync-yourevenings-eu-company-registers",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "lookup",
              "search",
              "newCompanies"
            ],
            "type": "string",
            "description": "<b>Look up</b> returns the companies you list by country and register ID. <b>Search</b> finds companies by name in each country's register (FR, NO, FI, CZ, IE). <b>Newly registered</b> lists companies registered in a date range (NO, FI, IE).",
            "default": "lookup"
          },
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "For <b>Look up</b>: up to 500 entries as COUNTRY:ID. FR = SIREN (9 digits, or a 14-digit SIRET), NO = organisasjonsnummer (9 digits), FI = Business ID (1234567-8), CZ = IČO (8 digits), IE = CRO company number, PL = KRS number (up to 10 digits). Unknown or invalid IDs get a free status row.",
            "items": {
              "type": "string"
            }
          },
          "defaultCountry": {
            "title": "Default country",
            "enum": [
              "FR",
              "NO",
              "FI",
              "CZ",
              "IE",
              "PL"
            ],
            "type": "string",
            "description": "For <b>Look up</b>: country to use for entries with no COUNTRY: prefix."
          },
          "name": {
            "title": "Company name",
            "type": "string",
            "description": "For <b>Search</b>: the company name or part of it (at least 2 characters)."
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "For <b>Search</b> and <b>Newly registered</b>: which registers to query. Empty = every register that supports the mode. A country that doesn't support the mode gets a free not_supported row.",
            "items": {
              "type": "string",
              "enum": [
                "FR",
                "NO",
                "FI",
                "CZ",
                "IE",
                "PL"
              ],
              "enumTitles": [
                "France",
                "Norway",
                "Finland",
                "Czechia",
                "Ireland",
                "Poland"
              ]
            }
          },
          "activeOnly": {
            "title": "Active companies only",
            "type": "boolean",
            "description": "For <b>Search</b> and <b>Newly registered</b>: leave out closed, dissolved or struck-off companies. FR, NO and IE filter at the register; for every country, rows whose status is inactive are dropped before charging and counted in a free <code>skipped_inactive</code> row. Companies in liquidation or bankruptcy are kept.",
            "default": false
          },
          "registeredWithinDays": {
            "title": "Registered in the last N days",
            "minimum": 0,
            "maximum": 366,
            "type": "integer",
            "description": "For <b>Newly registered</b>: a date range that ends today and starts N days earlier. Both days are included, so 7 covers 8 calendar days (today and the previous 7 days). Ignored when 'Registered since' is set. For an exact window, set 'Registered since' and 'Registered until'.",
            "default": 7
          },
          "registeredSince": {
            "title": "Registered since",
            "type": "string",
            "description": "For <b>Newly registered</b>: start date, YYYY-MM-DD. Set this and 'Registered until' for an exact window. When this is set, 'Registered in the last N days' is ignored."
          },
          "registeredUntil": {
            "title": "Registered until",
            "type": "string",
            "description": "For <b>Newly registered</b>: end date, YYYY-MM-DD. Default today. Set this and 'Registered since' for an exact window."
          },
          "includeOtherNorwegianEntities": {
            "title": "Include Norwegian estates, associations and foreign entities",
            "type": "boolean",
            "description": "For <b>Newly registered</b> in Norway: also return bankruptcy estates (konkursbo, KBO), associations (foreninger, FLI) and foreign entities (NUF and UTLA). Off by default. Sole traders (ENK) are always left out. Look-up by organisation number is unchanged.",
            "default": false
          },
          "legalFormCodes": {
            "title": "Legal form codes",
            "type": "array",
            "description": "For <b>Search</b> and <b>Newly registered</b>: keep only companies whose legal form code is in this list (for Norway, for example <code>AS</code> or <code>ASA</code>). Empty means no legal-form filter. Use the register's own codes.",
            "items": {
              "type": "string"
            }
          },
          "activityCodePrefixes": {
            "title": "Industry code prefixes",
            "type": "array",
            "description": "For <b>Search</b> and <b>Newly registered</b>: keep only companies that have at least one industry or activity code starting with one of these prefixes (for Norway, for example <code>62</code> for IT). Empty means no industry filter. A company can have more than one code; any of them can match, including current SN2025 codes on Norwegian records.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max records (whole run)",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many company records across all countries. 0 means no limit. You are charged per company record returned.",
            "default": 50
          },
          "maxResultsPerCountry": {
            "title": "Max records per country",
            "minimum": 0,
            "type": "integer",
            "description": "Stop each country after this many company records. 0 means no limit.",
            "default": 25
          },
          "monitorMode": {
            "title": "Monitor mode (only new or changed records)",
            "type": "boolean",
            "description": "Remember a fingerprint of each company (name, legal form, status, address, activity, website, VAT ID) and, on later runs, return only companies that are new or changed, with the changed fields and their old values. Schedule it to watch a list of companies or new registrations.",
            "default": false
          },
          "emitBaselineOnFirstRun": {
            "title": "Return records on the first monitor run",
            "type": "boolean",
            "description": "Off: the first monitor run only records what exists (no rows, no charges).",
            "default": true
          },
          "stateStoreName": {
            "title": "Monitor state store name",
            "type": "string",
            "description": "Named key-value store for monitor state. Use a different name per watch list.",
            "default": "eu-company-registers-monitor"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}