Get your e-Beyanname returns and tahakkuk fişleri as JSON

What you can build on e-Beyanname

• Search returns in Beyanname Ara

  Build this

  Reads the Beyanname Listesi on the Beyanname Ara screen for the criteria you give, with each return's status, messages and tahakkuk fiş number.

  Takes

  VKN or TCKN (optional), return type (optional), tax period (optional), upload date range, status (optional)

  Returns

  Return type, VKN, name or title, vergi dairesi, tax period, status, messages, tahakkuk fiş number

• Check sent packages in Paket Ara

  Build this

  Reads the Paket Ara list for a date range and status, then opens each package to read the returns inside it and the state of each one.

  Takes

  Start date, end date, status (Hatalı, Kontrol Bekliyor or Kontrol Edildi, optional)

  Returns

  Package name, upload time, TRANID, package status, returns in the package with VKN, type, period, status and messages

• Read a tahakkuk fişi

  Build this

  Opens the tahakkuk fişi of an approved return from its tahakkuk fiş number in Beyanname Ara and reads what the slip shows.

  Takes

  VKN, return type, tax period

  Returns

  Tahakkuk fiş number, VKN, name or title, vergi dairesi, return type, tax period, tax lines with amounts, total

• Approve a return awaiting approval

  Build this

  Finds one return in Onay Bekliyor status in Beyanname Ara, selects it and presses Onayla, then reads the result with its tahakkuk fiş number.

  Takes

  VKN, return type, tax period

  Returns

  VKN, return type, tax period, status, tahakkuk fiş number

Automate e-Beyanname 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.

• Hatalı returns in yesterday's packages

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Check sent packages in Paket Ara for the previous working day.

  Step 2

  Keep the returns in Hatalı status, with their messages.

  Step 3

  Email you the list, one line per return, so each can be corrected in BDP and sent again.

• Returns still in Onay Bekliyor

  Build this

  Starts

  Every weekday at 15:00

  Step 1

  Search returns in Beyanname Ara uploaded in the last 30 days with status Onay Bekliyor.

  Step 2

  Stop when there are none.

  Step 3

  Email you the list grouped by VKN, so each return is approved or cancelled before the deadline.

• New tahakkuk fişleri, posted to your accounting system

  Build this

  Starts

  Every weekday at 9:00

  Step 1

  Search returns in Beyanname Ara uploaded in the last 30 days that have a tahakkuk fiş number.

  Step 2

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

  Step 3

  For each, read the tahakkuk fişi and post VKN, return type, period, fiş number and total to your webhook.

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 “Search returns in Beyanname Ara” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "ebeyanname.gib.gov.tr/search_returns",
    "input": {
      "return_type": "MUHSGK",
      "tax_period": "2026/10",
      "uploaded_from": "2026-11-01",
      "uploaded_to": "2026-11-12"
    }
  }'

{
  "status": "completed",
  "data": {
    "returns": [
      {
        "return_type": "MUHSGK",
        "vkn": "1234567890",
        "name": "Acme Tekstil Ltd. Şti.",
        "vergi_dairesi": "Merkez",
        "tax_period": "2026/10",
        "status": "Onaylandı",
        "messages": [],
        "tahakkuk_fis_no": "2026111100001"
      }
    ],
    "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.

E-Beyanname’s own options

GİB's e-Beyanname documentation describes returns prepared in the Beyanname Düzenleme Programı or accounting software, packaged and uploaded on the site, not a web service. The new e-Beyan system, which now takes KDV returns outside İstanbul, has an API for legal entities whose e-Beyan Entegrasyon Başvurusu (integration application) GİB approves.

Read on November 12, 2026: e-Beyan Entegrasyon Kılavuzu, e-Beyanname Sık Sorulan Sorular, Dijital Vergi Dairesi duyurular.

Signing in to e-Beyanname

You reach e-Beyanname from Dijital Vergi Dairesi, which signs you in with your T.C. Kimlik No, Vergi Kimlik No or Kullanıcı Kodu and Şifre, or through e-Devlet. The e-Beyanname account itself is a kullanıcı kodu, parola and şifre issued by your vergi dairesi (tax office). With Fous you sign in once through the site's own sign-in. The login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

A return counts only once it is approved

Until you press Onayla, no tahakkuk fişi is issued and the return is not valid. A return in Hatalı status cannot be approved or cancelled: correct it in BDP and send it again.

Deadline is 24:00 on the last working day

A return can be sent until 24:00 on the working day its legal filing period ends, by the TRT clock. Late, correction and pişmanlık returns go through Özel Onay (special approval), which cannot be applied to several returns at once.

KDV returns are moving to e-Beyan

GİB announced on 2 November 2026 that KDV1, KDV2, KDV2B, KDV4 and KDV9015 are taken in the new e-Beyan system in every province except İstanbul. Check which system holds each return type before you build.

Two identical returns block approval

If the same return was sent twice and both are Onay Bekliyor, one has to be cancelled before the other can be approved. One package can hold returns of different taxpayers, taxes and periods.

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
• Dijital Vergi Dairesi
• myAADE
• Portal das Finanças

Other industries: MOT Testing Service, eFileIL, RP Data Professional, COD, MyFloridaMarketPlace Vendor Information Portal, OH|TAX eServices.