Documentation

v 1.2 - May 12, 2025

Overview

The CégadatAPI is a RESTful API designed to provide real-time access to accurate and up-to-date data on Hungarian companies. This service enables developers to integrate comprehensive company information into their applications, including ERP, CRM, and invoicing systems. The API retrieves data directly from the Hungarian Ministry of Justice’s Company Information Service, ensuring reliability and compliance with official records.

Authentication

To use the API, an API key is required. You can obtain your API key by registering at cegadatapi.hu/registration.
The key must be included in every request via the X-Api-Key header.

Endpoints

The API provides the following endpoints:

Search Companies:
- name: /v1/search?name={the name of the company}
- vatNumber: /v1/search?vatNumber={The company’s VAT number}
- regNumber: /v1/search?regNumber={The company’s registration number}
Get Company Details:
- id: /v1/detail?id={The company’s VAT number}

Search Companies

GET api.cegadatapi.hu/v1/search

This endpoint allows searching for companies based on name, VAT number, or registration number.

Parameters:

Parameter	Type	Description	Example
HEADER
X-Api-Key	string	Required. API key sent in the header.
GET
name	string	For searching by company name. Minimum 4 characters.	name=Welldata
vatNumber	number	Search by tax number. Exact match required.	vatNumber=32305964243
registryNumber	number	Search by company registration number. Exact match required.	registryNumber=0109417185
sensitivity	number	Sensitivity for company name search. 0 - Typo-tolerant (default) Supports misspellings and displays results in order of relevance. 1 - Partial match Results partially or fully contain the search term without typos. 2 - Exact match Returns results only for exact short or full company name matches.	sensitivity=1
limit	number	Maximum number of results. Value between 1 and 100. Default: 50	limit=100
page	number	Pagination, if there are multiple pages of results.	page=2
status	enum	Company status. Possible values: "Aktív", "Eljárás alatt" ("Active", "Under procedure")	status=Aktív

Example Request:

                 curl -G "https://api.cegadatapi.hu/v1/search" -H "X-Api-Key: 12345678" --data-urlencode "name=WellData"

                {
    "status": true,
    "response": {
        "meta": {
            "current": 1,
            "total_pages": 1,
            "total_results": 1,
            "size": 50
        },
        "results": [
            {
                "id": "32305964243",
                "vatNumber": "32305964243",
                "fullName": "WellData Korlátolt Felelősségű Társaság",
                "shortName": "WellData Kft.",
                "status": "Aktív"
            }
        ]
    }
}

Get Company Details

GET api.cegadatapi.hu/v1/detail

This endpoint retrieves detailed information about a specific company based on its VAT number.

Parameters:

Parameter	Type	Description	Example
HEADER
X-Api-Key	string	Required. API key sent in the header.
GET
id	number	The company identifier, which is also its tax number.	id=32305964243

Example Request:

                 curl -G "https://api.cegadatapi.hu/v1/detail" -H "X-Api-Key: 12345678" --data-urlencode "id=32305964243"

                {
    "status": true,
    "response": {
        "results": {
            "fullName": "WellData Korlátolt Felelősségű Társaság",
            "shortName": "WellData Kft.",
            "legalForm": "Korlátolt felelősségű társaság",
            "fullAddress": "1193 Budapest, Derkovits Gyula utca 53.",
            "addressCounty": "Budapest",
            "addressPostalCode": "1193",
            "addressCity": "Budapest",
            "addressStreet": "Derkovits Gyula utca 53.",
            "vatNumber": "32305964243",
            "registryNumber": "0109417185",
            "dateFounded": "2023-06-12",
            "statisticalCode": "32305964639911301",
            "website": "",
            "phoneNumber": "",
            "emailAddress": "[email protected]",
            "reportDate": "2023-12-31",
            "netRevenue": 28869000,
            "shareholdersEquity": "11304000",
            "operatingProfit": "12499000",
            "earningsBeforeTaxes": "12422000",
            "netSalesRevenues": "11304000",
            "totalAssets": "15863000",
            "employeeDate": "2023-12-31",
            "employeeCount": 2,
            "ownerCount": 1,
            "owners": [
                "Smidhoffer Vanessza Míra"
            ],
            "managerCount": 1,
            "managers": [
                "Smidhoffer Vanessza Míra"
            ],
            "principalActivity": "6399. M.n.s. egyéb információs szolgáltatás",
            "activities": [
                "6399. M.n.s. egyéb információs szolgáltatás",
                "6311. Adatfeldolgozás, web-hoszting szolgáltatás",
                "7311. Reklámügynöki tevékenység",
                "6312. Világháló-portál szolgáltatás",
                "6201. Számítógépes programozás",
                "6202. Információ-technológiai szaktanácsadás",
                "7022. Üzletviteli, egyéb vezetési tanácsadás",
                "5812. Címtárak, levelezőjegyzékek kiadása",
                "5829. Egyéb szoftverkiadás"
            ],
            "bankAccounts": [
                {
                    "bankName": "OTP Fiók Tapolca",
                    "accountNumber": "11748052-24863069-00000000"
                },
                {
                    "bankName": "OTP Veszprém m. Belföldiek Devizái",
                    "accountNumber": "11763488-58524886-00000000"
                }
            ],
            "branches": [],
            "branchOffices": [],
            "status": "Aktív"
        }
    }
}

Error Handling

If a request fails, the API returns an error message with an appropriate HTTP status code.

Error code	Status code	Message
1	400	The provided API key is not valid
2	400	Invalid API call
3	500	Internal server error occurred
4	400	The provided keyword is too short
5	401	Invalid or expired subscription
6	401	Invalid or discontinued plan
7	429	The plan limit has been reached
404	404	Unknown endpoint

Example Error Response:

                {
    "status": false,
    "error": "Invalid API Key",
    "errorCode": 1,
    "statusCode": 400
}

API key for testing purposes

The test API key allows for integration testing of the system. Please note that it is only suitable for simulating functionality and does not contain real data.

29.ea35adea153cbc8896913d744548dafc

Get Started Today! Sign up now and start using the API immediately.

Trusted by Our Clients.