aade-publicity-search

aade-publicity-search

Python client for the AADE Public AFM (VAT) lookup service, using the official SOAP API. It allows you to retrieve publicly available company / professional information by AFM and returns the result as a Python dictionary (JSON-ready).

---

Features

• 🔎 AFM (VAT) public lookup
• 🇬🇷 Official AADE SOAP service
• ⚡ Async / httpx based
• 🧼 Clean JSON output (dict)
• 🚫 No FastAPI dependency
• 🐍 Python 3.10+

---

Installation

pip install aade-publicity-search

import asyncio
from aade_publicity_search import AadeClient

async def main():
    client = AadeClient(
        username="AADE_USERNAME",
        password="AADE_PASSWORD"
    )

    data = await client.get_vat_info("123456789")
    print(data)

asyncio.run(main())

Returned data structure

The client returns a dictionary similar to:

{ "success": true, "error": { "code": null, "description": null }, "basic": { "afm": "123456789", "name": "COMPANY NAME", "doy": "ΔΟΥ ΑΘΗΝΩΝ", "legal_status": "ΑΤΟΜΙΚΗ ΕΠΙΧΕΙΡΗΣΗ" }, "firm_activities": [ { "activity_code": "62010000", "activity_descr": "Computer programming activities" } ] }

---

AFM validation

AFM numbers are validated locally before calling the AADE service.
If the AFM is invalid, a ValueError is raised.

---

Error handling

• HTTP errors raise httpx.HTTPStatusError

• Invalid AFM raises ValueError

• AADE service errors are returned in the error field of the response

Always check:

if not data["success"]: print(data["error"])

---

Requirements

• Python 3.10+

• Valid AADE SOAP credentials

• Internet access to AADE services

---

Disclaimer

This library uses the official AADE public SOAP service.
It is not affiliated with or endorsed by AADE.

Use responsibly and according to AADE terms of service.