Get your Dijital Vergi Dairesi debts and notices as JSON

What you can build on Dijital Vergi Dairesi

• Get tax debts

  Build this

  Reads Vadesi Geçmiş Borçlar, Vadesi Gelmemiş Borçlar and Toplam Borçlar on the Ana Sayfa (home page) and the debts listed on Borç Ödeme ve Detay.

  Takes

  Overdue only (optional)

  Returns

  Overdue total, not yet due total, total, and for each debt the tax type, period, due date, amount and whether it is overdue

• List e-Tebligat notices

  Build this

  Reads the notices in the e-Tebligat section: what each tax office sent to your electronic address and when.

  Takes

  Received since (optional)

  Returns

  Date received, sender, subject, opened or not

• Count e-Beyan returns by status

  Build this

  Opens the e-Beyan application from Geçiş Yapılabilecek Uygulamalar and reads its counters for draft, failed, awaiting approval and approved returns.

  Takes

  Nothing

  Returns

  Taslak, Hatalı, Onay Bekleyen and Onaylanan Beyannameler counts

Automate Dijital Vergi Dairesi 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.

• Overdue tax debts, every weekday morning

  Build this

  Starts

  Every weekday at 8:00, Europe/Istanbul

  Step 1

  Get the tax debts, overdue only, from Dijital Vergi Dairesi.

  Step 2

  Stop when Vadesi Geçmiş Borçlar is zero.

  Step 3

  Email you the overdue total and each debt's tax type, period, due date and amount.

• New e-Tebligat notices, posted to your team

  Build this

  Starts

  Every day at 9:00, Europe/Istanbul

  Step 1

  List the e-Tebligat notices received in the last 7 days.

  Step 2

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

  Step 3

  Post each one, with its date received, sender and subject, to your Slack or document system webhook.

• Weekly e-Beyan return check

  Build this

  Starts

  Every Monday at 8:30, Europe/Istanbul

  Step 1

  Count the e-Beyan returns by status.

  Step 2

  Stop when Hatalı and Onay Bekleyen Beyannameler are both zero.

  Step 3

  Email you the four counts.

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 “Get tax debts” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "dijital.gib.gov.tr/get_tax_debts",
    "input": {
      "overdue_only": false
    }
  }'

{
  "status": "completed",
  "data": {
    "currency": "TRY",
    "overdue_total": 18450,
    "not_yet_due_total": 42300,
    "total": 60750,
    "debts": [
      {
        "tax_type": "KDV",
        "period": "2026-09",
        "due_date": "2026-10-28",
        "amount": 18450,
        "overdue": true
      }
    ]
  }
}

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.

Dijital Vergi Dairesi’s own options

GİB's machine route is the e-Beyan REST API, which sends tax returns from your own software. It is open to intermediaries and legal entities with e-beyanname authority once GİB approves an e-Beyan Entegrasyon Başvurusu. Debts, payments and e-Tebligat are in Dijital Vergi Dairesi and the GİB mobile app.

Read on November 12, 2026: e-Beyan Entegrasyon Kılavuzu (2025), GİB mobile app listing, Dijital Vergi Dairesi.

Signing in to Dijital Vergi Dairesi

Dijital Vergi Dairesi signs you in with your T.C. Kimlik No, Vergi Kimlik No or Kullanıcı Kodu and a password, or through e-Devlet, and İnteraktif Vergi Dairesi passwords still work. With Fous you sign in once through the site's own sign-in with your own account: the login is sealed with AES-256, never returned by the API or written to logs, and an expired session is signed back in.

Worth knowing

An e-Tebligat counts as served on the fifth day

A notice is treated as delivered on the fifth day after it reaches your electronic address, whether or not anyone opened it. Reading e-Tebligat every day keeps that fifth day from passing unseen.

Only the main user can create an API token

e-Beyan tokens are created under Entegrasyon Yönetimi by the main user, not by sub-users. The token is shown once, and each of Pre-Prod, Pilot and Prod needs its own.

The API is tied to approved IP addresses

The e-Beyan API answers only from the IP addresses approved in your application. To change them, GİB cancels the approved application and you apply again.

One site in place of İnteraktif Vergi Dairesi

Dijital Vergi Dairesi went live on 7 October 2023 and took over İnteraktif and İnternet Vergi Dairesi in phases, with e-Beyanname and Defter-Beyan Sistemi reached from it.

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

• Telemaco
• EUDR Information System
• Road Transport Posting Declaration Portal
• EU Funding & Tenders Portal
• Cégkapu
• UETS
• EPREL
• e-Zamówienia
• Mercell
• NEN
• Plataforma de Contratación del Sector Público
• Prozorro
• TRACES NT
• e-ΕΦΚΑ
• PUE ZUS
• Segurança Social Direta
• SGK İşveren Sistemi
• Sociálna poisťovňa e-Služby
• myAADE
• Portal das Finanças
• e-Beyanname

Other industries: ePortal ESTV, Metrc, NMLS, TRACS / iMAX, Cal eProcure, NCDOR eBusiness Center.