{
  "openapi": "3.0.1",
  "info": {
    "title": "EU Company Registry & VAT Number Lookup: NIP, KRS, SIREN, LEI",
    "description": "Polish company lookup by NIP or KRS with VAT status check (white list), plus VAT number lookup and business registry for Norway, Finland, Czech (ARES), Slovakia, France, Latvia, Lithuania, Ireland (CRO), Estonia, LEI. Active, liquidation or bankruptcy status, NACE. New companies. Not Germany.",
    "version": "0.1",
    "x-build-id": "viy5SHeWBVdf4idpM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidfetch~eu-company-registry/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidfetch-eu-company-registry",
        "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/solidfetch~eu-company-registry/runs": {
      "post": {
        "operationId": "runs-sync-solidfetch-eu-company-registry",
        "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/solidfetch~eu-company-registry/run-sync": {
      "post": {
        "operationId": "run-sync-solidfetch-eu-company-registry",
        "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": "What to do",
            "enum": [
              "lookup",
              "search",
              "newSince"
            ],
            "type": "string",
            "description": "Lookup reads the companies behind your IDs. Search finds companies by name. New companies lists companies registered in the date window, for PL, NO, FI, CZ and SK (and IE and EE when you list them in Countries). Left empty, the actor picks the mode from the field you filled: IDs, names or a since date."
          },
          "ids": {
            "title": "IDs (lookup)",
            "type": "array",
            "description": "One ID per line. VAT numbers with the country prefix (PL5260250995, NO923609016MVA, FI01120389, CZ00177041, FR27552032534), registry numbers (KRS 19193, NIP, REGON, Norwegian orgnr, Finnish Y-tunnus 0112038-9, Czech or Slovak IČO, French SIREN or SIRET, Latvian registration number, Lithuanian legal entity code, Irish CRO company number as IE104547 or cro 104547, Estonian registry code as EE10137025 or registry code 10137025) or LEIs. Latvian VAT numbers (LV40003032949) and Estonian VAT numbers (EE100210460) work too. An Irish VAT number is a different number and is refused: enter the CRO number. Lithuanian VAT numbers do not match the legal entity code and are refused: enter the 9-digit code, for example kodas 301844044. A bare number is matched to every country whose format and check digit it fits; set Countries to narrow it.",
            "items": {
              "type": "string"
            }
          },
          "names": {
            "title": "Company names (search)",
            "type": "array",
            "description": "Names to search in each country's register. Poland has no name search in KRS, so Polish names are found through GLEIF and cover companies with an LEI only.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter codes. Search: PL, NO, FI, CZ, SK, FR, LV, LT, IE, EE use the national register (default: PL, NO, FI, CZ, SK, FR; add LV, LT, IE or EE to include them); any other code, such as DE or IT, searches GLEIF (companies with an LEI). New companies: PL, NO, FI, CZ, SK (default: these five; add IE or EE to include Ireland or Estonia). Lookup: optional, narrows bare numbers; a bare 8-digit number is read as an Estonian registry code and a number of up to 7 digits as an Irish company number only when EE or IE is listed.",
            "items": {
              "type": "string"
            }
          },
          "since": {
            "title": "Registered since (new companies)",
            "type": "string",
            "description": "A date like 2026-09-01, or a number of days like \"7 days\" so a scheduled run always asks for the latest days. Each register keeps a limited history for this: Czechia about one month, Slovakia 45 days."
          },
          "until": {
            "title": "Registered until",
            "type": "string",
            "description": "Optional end date (inclusive). Default: today."
          },
          "maxItems": {
            "title": "Maximum companies",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "The run stops after saving this many companies. You pay per saved company.",
            "default": 100
          },
          "maxResultsPerName": {
            "title": "Results per name and country (search)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many of the best name matches to keep for each name in each country.",
            "default": 5
          },
          "addLei": {
            "title": "Add the LEI",
            "type": "boolean",
            "description": "Look up each company in GLEIF and add its LEI when it has one. GLEIF allows 60 calls a minute, so this adds about one second per company. Default: on for lookup, off for search and new companies."
          },
          "includeFinancials": {
            "title": "Add annual accounts (Norway, Estonia)",
            "type": "boolean",
            "description": "Norwegian companies only: add the key figures of the latest annual accounts (year, currency, revenue, operating result, net result, equity, total assets, audited) from the Brønnøysund Regnskapsregisteret. One extra request per company, same price per company. Companies with no accounts, or accounts the register does not publish (banks), get the reason in financialsError. Estonian companies: the same figures (in EUR, no operating result) from the e-Business Register's monthly annual-report files, read in one pass for a batch of companies. Sole traders are never returned.",
            "default": false
          },
          "onlyActive": {
            "title": "Active companies only",
            "type": "boolean",
            "description": "Search and new companies: drop companies in liquidation, bankruptcy or dissolved. Lookup always returns the company with its status.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}