Turn Egyptian Tax Authority e-Services into an API

What you can build on the e-tax portal

• List VAT invoices for a tax period

  Build this

  Reads عرض الفواتير (view invoices) under القيمة المضافة (VAT) for one tax period, sales or purchases.

  Takes

  Tax period (month and year), sales or purchases

  Returns

  Invoice number, invoice date, counterparty name, counterparty registration number, amount before tax, VAT

• List submitted returns

  Build this

  Reads عرض الإقرارات (view returns) under القيمة المضافة or ضريبة الدخل (income tax) for the years you name.

  Takes

  Tax type (VAT or income tax), year

  Returns

  Form number, tax period, submission date, tax due

• List withholding transactions

  Build this

  Reads عرض التعاملات (view transactions) under الخصم والتحصيل (withholding and collection), or only the rows listed in عرض التعاملات الخاطئة (view erroneous transactions).

  Takes

  Tax period, all or erroneous only

  Returns

  Transaction date, counterparty name, counterparty registration number, amount, tax withheld, error

• Add a withholding transaction

  Build this

  Opens اضافة تعامل (add transaction) under الخصم والتحصيل, fills in one transaction and saves it.

  Takes

  Counterparty registration number, transaction date, amount, tax withheld

  Returns

  Counterparty name, transaction date, amount, tax withheld, saved or error

Automate the e-tax portal with a workflow

A workflow 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.

• Last month's VAT invoices, totalled for finance

  Build this

  Starts

  On the 3rd of every month at 9:00, Cairo time

  Step 1

  Get last month's sales invoices and purchases invoices from عرض الفواتير.

  Step 2

  An AI step totals amount before tax and VAT for each side and lists the ten largest invoices.

  Step 3

  Email you the totals and the list before the نموذج 10 return is prepared.

• New erroneous withholding transactions

  Build this

  Starts

  Every Monday at 8:00, Cairo time

  Step 1

  Read the current period's rows in عرض التعاملات الخاطئة.

  Step 2

  Keep the rows that were not there on the last run.

  Step 3

  Post each one, with counterparty, amount and the error, to your accounting system's webhook.

• New VAT and income tax returns in عرض الإقرارات

  Build this

  Starts

  On the 1st of every month at 10:00, Cairo time

  Step 1

  Get this year's VAT returns and income tax returns from عرض الإقرارات.

  Step 2

  Keep the returns that were not there on the last run.

  Step 3

  Email you form number, tax period, submission date and tax due.

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, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “List VAT invoices for a tax period” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "eservice.incometax.gov.eg/list_vat_invoices",
    "input": {
      "tax_period": "2026-10",
      "side": "sales"
    }
  }'

{
  "status": "completed",
  "data": {
    "tax_period": "2026-10",
    "side": "sales",
    "invoices": [
      {
        "invoice_number": "INV-2026-1184",
        "invoice_date": "2026-10-07",
        "counterparty_name": "Northwind Trading S.A.E.",
        "counterparty_registration_number": "100-200-300",
        "amount_before_tax": 48500,
        "vat": 6790,
        "currency": "EGP"
      }
    ],
    "count": 1
  }
}

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.

The e-tax portal’s own options

The Egyptian Tax Authority publishes APIs for e-invoices and e-receipts, for taxpayers' ERP and POS systems. The e-tax portal itself, where VAT, withholding, payroll and income tax returns are filed, has no published API: it takes invoices and withholding transactions as file imports from its own templates, and everything else by hand.

Read on November 12, 2026: ETA eInvoicing and eReceipt SDK, E-tax portal (menus and sign-in).

Signing in to the e-tax portal

The e-tax portal signs you in with your user name and password, with a تذكرنى (remember me) option, and resets a forgotten password by email. Taxpayers and accountants register separately, and completing an account's details asks for an activation code sent by email. With Fous you sign in once through the portal's own sign-in, the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Expenses count only through e-invoices

The portal tells taxpayers that from 1 July 2023 expenses are accepted in the tax return only through the electronic invoice. A purchase without an e-invoice does not count as an expense.

Imports have their own error list

The withholding menu lists عرض التعاملات الخاطئة (view erroneous transactions) beside استيراد التعاملات من الملف (import transactions from file). VAT invoice imports follow the portal's templates and إرشادات إستيراد الفواتير.

VAT and withholding close periods separately

The VAT menu and the withholding menu each have their own غلق الفترة الضريبية (close tax period) entry. None of the methods above closes a period.

ETA runs a second taxpayer portal

eta.gov.eg also links بوابة الممول (taxpayer portal) on workspace.eta.gov.eg, with its own guides for the new main tax system. Check which portal your returns are filed on before you build.

More in Government: Middle East and Africa

• CAC Company Registration Portal
• CIPC eServices
• GDRFA Dubai Smart Services
• eTIMS
• Rev360
• Qiwa
• ICP Smart Services
• KRA iTax
• SARS eFiling
• SIMPL
• ZATCA e-Services
• uFiling
• EmaraTax
• Mudad

Other industries: Plataforma de Contratación del Sector Público, MOT Testing Service, Florida Courts E-Filing Portal, LMS Conveyancer Zone, CM/ECF, NC eProcurement.