# Read your myAADE tax account through an API

> Read the debts in Ο Λογαριασμός μου (my account), your arrangement installments and the messages in your myAADE inbox with one API call each. A workflow can check the account each morning and email you any new debt or message.

Page: https://fous.com/automate/myaade
Updated: 2026-11-12

Works with your own myAADE account. Fous is an independent product.

## What you can build on myAADE

### Get debts outside an arrangement

Reads Οφειλές εκτός ρύθμισης και πληρωμές (debts outside an arrangement and payments) under Ο Λογαριασμός μου (my account).

- Takes: Nothing
- Returns: Description, amount, total

### Get arrangements and installments

Reads Οφειλές σε Ρύθμιση και Πληρωμή (debts in an arrangement) under Ο Λογαριασμός μου: each arrangement and its next installment.

- Takes: Nothing
- Returns: Arrangement, ΤΡΟ, installment amount, installment due date

### Read new messages

Reads Τα Μηνύματά μου (my messages) under Μητρώο & Επικοινωνία (registry and contact), where AADE sends you messages.

- Takes: Received since (optional)
- Returns: Date, subject, message text

### Issue a tax clearance certificate

Requests a certificate for the purpose you choose in Έκδοση Αποδεικτικού Ενημερότητας, under Εφαρμογές > Φορολογικές Υπηρεσίες > Ενημερότητα (tax clearance).

- Takes: Purpose
- Returns: Issued or not, purpose, message shown

## Automate myAADE with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New debts in Ο Λογαριασμός μου, every morning

Starts: Every weekday at 8:00 (Europe/Athens)

1. Get the debts listed under Οφειλές εκτός ρύθμισης και πληρωμές.
2. Keep the debts that were not there on the last run.
3. Email you each new debt with its description and amount, and the new total.

### Arrangement installments, sent to your accounting system

Starts: Every Monday at 9:00 (Europe/Athens)

1. Get each arrangement in Οφειλές σε Ρύθμιση και Πληρωμή with its next installment.
2. Keep the installments whose amount or due date changed since the last run.
3. Post arrangement, ΤΡΟ, installment amount and due date to your accounting system's webhook.

### New messages in Τα Μηνύματά μου, summarized

Starts: Every day at 7:30 (Europe/Athens)

1. Read the messages in Τα Μηνύματά μου received since yesterday.
2. Stop when there are none.
3. Summarize each message in a sentence and email you the summaries with the full texts.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get debts outside an arrangement” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www1.aade.gr/get_debts_outside_arrangement",
    "input": {}
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "debts": [
      {
        "description": "ΦΠΑ, tax period 2026-09",
        "amount": 4812.4
      },
      {
        "description": "Παρακρατούμενοι φόροι μισθωτών, tax period 2026-09",
        "amount": 1265
      }
    ],
    "total": 6077.4,
    "currency": "EUR"
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## MyAADE’s own options

AADE runs a REST API for myDATA, with a registration form for its test (Dev) environment. The myAADE portal offers Ο Λογαριασμός μου, Τα Αιτήματά μου (my requests), Τα Ραντεβού μου (my appointments), Μητρώο & Επικοινωνία and Εφαρμογές (applications) as screens you sign in to, and its pages mention no API for debts, arrangements or tax clearance.

| Option | What it covers | What it takes |
| --- | --- | --- |
| myDATA REST API | myDATA only, through a REST API, with a separate test (Dev) environment. | For the Dev environment, a registration form that asks for a user name, ΑΦΜ (tax number) and a key. |
| Bank payment with the ΤΡΟ | Paying arrangement installments through e-banking, phone or mobile banking, ATM or a bank branch. | The arrangement's ΤΡΟ and the payment category «Βεβαιωμένες Οφειλές σε ΔΟΥ». |
| myAADE by hand | Debts, payments and refunds, arrangements, messages, tax clearance, requests and appointments, one screen at a time. | TAXISnet user name and password. |

Read on November 12, 2026: [myAADE portal home](https://www1.aade.gr/aadeapps3/myaade/), [myDATA REST API registration (Dev)](https://mydata-dev-register.azurewebsites.net/).

## Signing in to myAADE

myAADE signs you in on the TAXISnet page at login.gsis.gr with a user name (Όνομα χρήστη) and password (Κωδικός πρόσβασης). With Fous you sign in there once with your own TAXISnet account, and the login is sealed with AES-256 and never shown to your code or AI agents. When the session expires, Fous signs back in.

## Worth knowing

- **Installments are not paid in myAADE**: Arrangement installments cannot be paid through myAADE. You pay them at a bank with the Ταυτότητα Ρυθμισμένης Οφειλής (ΤΡΟ), which stays the same until the arrangement is paid off.
- **A bilateral arrangement shows after one payment**: A bilateral arrangement shows in myAADE only after the first installment is paid. Its ΤΡΟ, first due date and first amount arrive earlier as a message in Τα Μηνύματά μου.
- **Card payment only on your own filing**: The «Αυτόματη πληρωμή με κάρτα / IRIS» link appears after a VAT or withholding return only when you file it with your own credentials, not through an accountant or representative.
- **Who gets a digital tax clearance**: Overdue debts up to €30 in total still allow a certificate for most purposes. Debts in the out-of-court mechanism (ν.4738/2020) or a court arrangement (ν.3869/2010) do not get one digitally.

## More in Government: Southern, Eastern and Nordic Europe, EU

- [Telemaco](https://fous.com/automate/telemaco.md)
- [EUDR Information System](https://fous.com/automate/eudr-information-system.md)
- [Road Transport Posting Declaration Portal](https://fous.com/automate/road-transport-posting-declaration-portal.md)
- [EU Funding & Tenders Portal](https://fous.com/automate/eu-funding-and-tenders-portal.md)
- [Cégkapu](https://fous.com/automate/cegkapu.md)
- [UETS](https://fous.com/automate/uets.md)
- [EPREL](https://fous.com/automate/eprel.md)
- [e-Zamówienia](https://fous.com/automate/e-zamowienia.md)
- [Mercell](https://fous.com/automate/mercell.md)
- [NEN](https://fous.com/automate/nen.md)
- [Plataforma de Contratación del Sector Público](https://fous.com/automate/plataforma-de-contratacion-del-sector-publico.md)
- [Prozorro](https://fous.com/automate/prozorro.md)
- [TRACES NT](https://fous.com/automate/traces-nt.md)
- [e-ΕΦΚΑ](https://fous.com/automate/e-efka.md)
- [PUE ZUS](https://fous.com/automate/pue-zus.md)
- [Segurança Social Direta](https://fous.com/automate/seguranca-social-direta.md)
- [SGK İşveren Sistemi](https://fous.com/automate/sgk-isveren-sistemi.md)
- [Sociálna poisťovňa e-Služby](https://fous.com/automate/socialna-poistovna-e-sluzby.md)
- [Dijital Vergi Dairesi](https://fous.com/automate/dijital-vergi-dairesi.md)
- [Portal das Finanças](https://fous.com/automate/portal-das-financas.md)
- [e-Beyanname](https://fous.com/automate/e-beyanname.md)

Other industries: [FinanzOnline](/automate/finanzonline), [webDEALER](/automate/webdealer), [MERS Online](/automate/mers-online), [USPTO Patent Center](/automate/uspto-patent-center), [COMMBUYS](/automate/commbuys), [New Jersey Tax Portal](/automate/new-jersey-tax-portal).

## Frequently asked questions

### Does myAADE have an API?

Not for the account screens. AADE offers a REST API for myDATA, with a test (Dev) registration, but the myAADE pages offer debts, arrangements, messages and tax clearance only as screens you sign in to. A method you build reads those screens with your own TAXISnet account.

### Is Fous affiliated with AADE?

No. Fous is an independent product. It works with your own myAADE account, through the same TAXISnet sign-in you use yourself, and reads and does only what that account can.

### When does a VAT or withholding amount show in Ο Λογαριασμός μου?

Right after you file the return. The amount appears under Ο Λογαριασμός μου > Οφειλές εκτός ρύθμισης και πληρωμές, and a card or IRIS payment is credited at once, so a tax clearance certificate can be issued straight after.

### Can I pay arrangement installments in myAADE?

No. You see the arrangements under Οφειλές σε Ρύθμιση και Πληρωμή, but you pay each installment at a bank with its ΤΡΟ, choosing «Βεβαιωμένες Οφειλές σε ΔΟΥ».

### Can I get a tax clearance certificate with debts in an arrangement?

Yes, for most purposes, when the arrangement is up to date, with a withholding for collections or property transfers. With debts in the out-of-court mechanism or a court arrangement, the certificate is not issued digitally.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of myAADE (AADE (Independent Authority for Public Revenue)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.