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.