VAT-number-finder-API (Node.js)

This is a minimal Node.js + Express server that acts as an API wrapper around Finančná správa SR's open data interface.
It allows you to look up Slovak companies by their IČO number (company identifier).

Features

Accepts GET requests with an IČO as query parameter
Returns company information in JSON format
Built with Express and Axios
Hardcoded API key for simplicity

Setup Instructions

Download and extract the project
Open server.js and replace:

const API_KEY = "your_api_key_here";

with your actual API key from https://iz.opendata.financnasprava.sk

In the project directory, run:

npm install express axios

Start the server:

node server.js

Use the API:

Open your browser or use curl/Postman:

http://localhost:3000/api/lookup?ico=36215589

Example response

{
    "page": 1,
    "pages": 1,
    "itemsCount": 1,
    "itemsPerPage": 1000,
    "data": [
        {
            "id": 3081331,
            "dic": "2020041199",
            "ico": "36215589",
            "nazov_ds": "Singularity, s.r.o.",
            "obec": "Michalovce",
            "psc": "07101",
            "ulica_cislo": "Nám. Slobody 7",
            "nazov_statu": "Slovensko"
        }
    ]
}

Requirements

Node.js 14 or newer
Internet connection
Valid API key from Finančná správa SR