Dokumentáció

Hitelesítés

Az API használatához API-kulcs szükséges, amelyet a regisztrációs oldalon (cegadatapi.hu/regisztracio) oldalon igényelhet. igényelhet. A kulcsot minden kérés során az X-Api-Key fejlécben kell továbbítani. Minden kommunikáció titkosított HTTPS protokollon keresztül történik.

Keresési végpont

GET api.cegadatapi.hu/v1/search

Ez a végpont lehetővé teszi magyar társas vállalkozások és egyéni vállalkozók keresését név, adószám vagy cégjegyzékszám alapján.

Paraméterek:

Paraméter	Típus	Leírás	Példa
HEADER
X-Api-Key	string	Kötelező. Header-ben küldött API kulcs.
GET
name	string	Cégnév alapján történő kereséshez. Minimum 4 karakter.	name=Welldata
vatNumber	number	Keresés adószám alapján. Pontos egyezés szükséges.	vatNumber=32305964243
registryNumber	number	Keresés cégjegyzékszám alapján. Pontos egyezés szükséges.	registryNumber=0109417185
businessType	enum	A keresett vállalkozások típusa. 'company' (alapértelmezett) - Csak társas vállalkozásokat keres (pl. Kft., Zrt., Bt.). 'individualEntrepreneur' - Csak egyéni vállalkozásokat keres. 'all' - Társas vállalkozásokat és egyéni vállalkozásokat egyaránt keres.	businessType=all
sensitivity	number	Érzékenység cégnév keresés esetén. 0 - elírásbarát (alapértelmezett) Támogatja az elgépeléseket, a találatokat relevancia sorrendjében jeleníti meg. 1 - részleges egyezés A találatok részben vagy egészében, elírás nélkül tartalmazzák a keresési kifejezést. 2 - pontos egyezés Pontos rövid vagy teljes cégnév megadás esetén ad vissza találatot.	sensitivity=1
limit	number	Találatok száma legfeljebb. 1-100 közötti érték, Alapértelmezett: 50	limit=100
page	number	Lapozás, amennyiben több oldalnyi találat van	page=2
status	enum	A vállalkozás állapota. Lehetséges értékek: "Aktív", "Eljárás alatt", "Szüneteltetett"	status=Aktív

Társas vállalkozások keresése (alapértelmezett):

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

Egyéni vállalkozók keresése:

                 curl -G "https://api.cegadatapi.hu/v1/search"
     -H "X-Api-Key: 12345678"
     --data-urlencode "name=Kovács Lajos"
     --data-urlencode "businessType=individualEntrepreneur"

Összes vállalkozás keresése:

                 curl -G "https://api.cegadatapi.hu/v1/search"
     -H "X-Api-Key: 12345678"
     --data-urlencode "name=Kovács Lajos"
     --data-urlencode "businessType=all"

Minta válasz:

                    {
    "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"
            }
        ]
    }
}

Adatlap lekérés

GET api.cegadatapi.hu/v1/detail

Ez a végpont lehetővé teszi társas vállalkozások és egyéni vállalkozók részletes adatlapjának lekérését adószám alapján.

Paraméterek:

Paraméter	Típus	Leírás	Példa
HEADER
X-Api-Key	string	Kötelező. Header-ben küldött API kulcs.
GET
id	number	A cég azonosítója, ami az adószáma is egyben.	id=32305964243

Társas vállalkozás adatlapjának lekérése:

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

Példa válasz – Társas vállalkozás:

                {
    "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": "32305964639211301",
            "website": "",
            "phoneNumber": "",
            "emailAddress": "[email protected]",
            "reportDate": "2024-12-31",
            "netRevenue": 62188000,
            "shareholdersEquity": "29009000",
            "operatingProfit": "28099000",
            "earningsBeforeTaxes": "28149000",
            "netSalesRevenues": "25616000",
            "totalAssets": "33476000",
            "employeeDate": "2024-12-31",
            "employeeCount": 2,
            "ownerCount": 1,
            "owners": [
                "Smidhoffer Vanessza Míra"
            ],
            "managerCount": 1,
            "managers": [
                "Smidhoffer Vanessza Míra"
            ],
            "principalActivity": "6392. Egyéb információs szolgáltatás",
            "activities": [
                "6392. Egyéb információs szolgáltatás",
                "6311. Adatfeldolgozás, web-hoszting szolgáltatás",
                "6312. Világháló-portál szolgáltatás",
                "5819. Egyéb kiadói tevékenység (kivéve: szoftverkiadás)",
                "5829. Egyéb szoftverkiadás",
                "6210. Számítógépes programozás",
                "6220. Információtechnológiai szaktanácsadás és számítástechnikai eszközök, rendszerek üzemeltetése",
                "7020. Üzletviteli, egyéb üzletvezetési tanácsadás",
                "7311. Reklámügynöki tevékenység"
            ],
            "bankAccounts": [
                {
                    "bankName": "OTP Fiók Tapolca",
                    "accountNumber": "11748052-24863069-00000000",
                    "effectiveFrom": "2023-06-19"
                },
                {
                    "bankName": "OTP Veszprém m. Belföldiek Devizái",
                    "accountNumber": "11763488-58524886-00000000",
                    "effectiveFrom": "2023-06-19"
                }
            ],
            "branches": [],
            "branchOffices": [],
            "status": "Aktív",
            "parentCompanies": [],
            "subsidiaries": []
        }
    }
}

Egyéni vállalkozó adatlapjának lekérése:

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

Példa válasz – Egyéni vállalkozó:

                {
    "status": true,
    "response": {
        "results": {
            "fullName": "Kovács Lajos",
            "legalForm": "Egyéni vállalkozás",
            "fullAddress": "2330 Dunaharaszti, Kaszala Károly utca 16.",
            "addressCounty": "Pest",
            "addressPostalCode": "2330",
            "addressCity": "Dunaharaszti",
            "addressStreet": "Kaszala Károly utca 16.",
            "vatNumber": "64261351133",
            "registryNumber": "9127416",
            "dateFounded": "2005-04-13",
            "statisticalCode": "64261351812123113",
            "revenue": 3120000,
            "netIncome": 1560000,
            "principalActivity": "8121. Általános épülettakarítás",
            "activities": [
                "477104. Vegyes ruházati kiskereskedelem",
                "477201. Lábbeli-kiskereskedelem",
                "477202. Bőrdíszműáru-kiskereskedelem",
                "477813. Ajándéktárgy-, bizsu-kiskereskedelem",
                "477902. Használtruha-, lábbeli-kiskereskedelem"
            ],
            "branches": [],
            "status": "Aktív"
        }
    }
}

Hibaüzenetek

Az API hagyományos HTTP állapotkódokat használ a lekérési állapot jelzésére.
Sikertelen kérés esetén JSON válaszban érhető el további információ a hiba okáról.

Hibakód	Státuszkód	Üzenet
1	400	A megadott API kulcs nem érvényes
2	400	Érvénytelen API hívás
3	500	Belső szerver hiba történt
4	400	A megadott kulcsszó túl rövid
5	401	Érvénytelen, vagy lejárt előfizetés
6	401	Érvénytelen, vagy megszűnt csomag
7	429	A csomagban foglalt limit elérve
404	404	Ismeretlen végpont

Hibaüzenet minta:

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

Teszteléshez használható API kulcs

A teszt API-kulcs lehetővé teszi a CégadatAPI integrációs tesztelését fejlesztési környezetben. Ez a kulcs szimulációs célokat szolgál, és kizárólag az alább felsorolt magyar vállalkozások valós adataihoz biztosít hozzáférést – egyéb cégek adatai nem lekérdezhetők vele.

A teszt API-kulcs használatával az alábbi vállalkozások adatai kérhetők le:

WellData Kft. (32305964-2-43)
Dayton Invest Kft. (14945083-2-41)
Coca-Cola HBC Magyarország Kft. (10886861-2-44)
Budapest Film Zrt. (10906110-2-42)
Blikk Kft. (24873862-2-43)
Kovács Lajos (64261351-1-33)
Pál Brigitta (64435314-1-23)

29.ea35adea153cbc8896913d744548dafc