{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Registry Search: GLEIF LEI, Norway & Finland",
    "description": "$3.50 per 1,000 companies found. Search company records in GLEIF (LEI), Norway's Brreg and Finland's PRH registers by name, registration number, or municipality and industry. One row per company: name, legal form, status, industry code, address, website, employees. No people. No login or API key.",
    "version": "0.0",
    "x-build-id": "31W1qYjcbmt7wakIg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/conserving_celerytop~open-company-registries/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-conserving_celerytop-open-company-registries",
        "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/conserving_celerytop~open-company-registries/runs": {
      "post": {
        "operationId": "runs-sync-conserving_celerytop-open-company-registries",
        "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/conserving_celerytop~open-company-registries/run-sync": {
      "post": {
        "operationId": "run-sync-conserving_celerytop-open-company-registries",
        "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": {
          "companyNames": {
            "title": "Company names",
            "type": "array",
            "description": "Company names or parts of names to search for. Each name is searched in every registry picked under Registries.",
            "items": {
              "type": "string"
            }
          },
          "registrationNumbers": {
            "title": "Registration numbers",
            "type": "array",
            "description": "LEI codes (20 characters), Norwegian organisation numbers (9 digits) or Finnish Business IDs (1234567-8). Each number goes to the registry it belongs to.",
            "items": {
              "type": "string"
            }
          },
          "registries": {
            "title": "Registries",
            "type": "array",
            "description": "Registries to search company names in: gleif (Global LEI Index, all countries), norway (Brønnøysund Register Centre) and finland (PRH trade register).",
            "items": {
              "type": "string",
              "enum": [
                "gleif",
                "norway",
                "finland"
              ],
              "enumTitles": [
                "GLEIF Global LEI Index",
                "Norway (Brreg)",
                "Finland (PRH)"
              ]
            },
            "default": [
              "gleif",
              "norway",
              "finland"
            ]
          },
          "maxResultsPerSearch": {
            "title": "Results per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Most companies to return for one name in one registry.",
            "default": 10
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Most rows for the whole run, across all names, numbers and registries.",
            "default": 100
          },
          "activeOnly": {
            "title": "Active companies only",
            "type": "boolean",
            "description": "Return active companies only in name searches. Lookups by registration number always return the company, with its status.",
            "default": true
          },
          "areas": {
            "title": "Municipalities or cities",
            "type": "array",
            "description": "Find active companies whose business address is in these places. Norway: municipality name or four-digit municipality number (Oslo, Bergen, 0301). Finland: city or town (Helsinki, Espoo). Leave empty to skip the area search.",
            "items": {
              "type": "string"
            }
          },
          "areaCountry": {
            "title": "Country for area search",
            "enum": [
              "norway",
              "finland"
            ],
            "type": "string",
            "description": "Register to search by area.",
            "default": "norway"
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Plain-language industries. Each maps to official industry codes. Leave empty and add no industry codes to get every industry.",
            "items": {
              "type": "string",
              "enum": [
                "restaurants",
                "cafes-bars",
                "hotels",
                "hair-beauty",
                "fitness",
                "construction",
                "electricians-plumbers",
                "cleaning",
                "real-estate-agents",
                "it-consulting",
                "marketing-advertising",
                "accounting",
                "legal",
                "architecture-engineering",
                "retail",
                "car-repair"
              ],
              "enumTitles": [
                "Restaurants and food service",
                "Bars and cafés",
                "Hotels",
                "Hair and beauty",
                "Gyms and fitness centres",
                "Construction",
                "Electricians and plumbers",
                "Cleaning",
                "Real estate agents",
                "IT consulting and software",
                "Marketing and advertising",
                "Accounting and bookkeeping",
                "Legal services",
                "Architecture and engineering",
                "Retail shops",
                "Car repair"
              ]
            }
          },
          "industryCodes": {
            "title": "Industry codes",
            "type": "array",
            "description": "NACE based industry codes, as used by both registers today (Norway SN2025, Finland TOL 2025), for example 56.1, 62.01 or 4321. Each code includes the codes under it.",
            "items": {
              "type": "string"
            }
          },
          "postalCodes": {
            "title": "Postal codes",
            "type": "array",
            "description": "Optional. Keep only companies whose business address has one of these postal codes (Norway 4 digits, Finland 5 digits). Can be used without a municipality.",
            "items": {
              "type": "string"
            }
          },
          "registeredSince": {
            "title": "Registered since",
            "type": "string",
            "description": "Only companies registered on or after this date. A date (2026-01-01) or a period back from today such as 30 days or 6 months. Newest companies come first."
          },
          "maxResultsPerArea": {
            "title": "Results per area",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Most companies for one municipality or city (and postal code). Max results still caps the whole run.",
            "default": 1000
          },
          "leiCountries": {
            "title": "LEI countries",
            "type": "array",
            "description": "Two-letter country codes of the legal address, such as DE or SE. Applies to GLEIF name searches only.",
            "items": {
              "type": "string"
            }
          },
          "maxRetries": {
            "title": "Max retries",
            "minimum": 0,
            "maximum": 3,
            "type": "integer",
            "description": "Retries per request after a timeout or a server error, with growing pauses.",
            "default": 3
          },
          "userAgent": {
            "title": "User-Agent",
            "type": "string",
            "description": "User-Agent header sent to the registry APIs. Keep a contact address in it.",
            "default": "open-company-registries/0.1 (Apify Actor; contact don.mangu.data@gmail.com)"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}