# Get your Dijital Vergi Dairesi debts and notices as JSON

> Read your Vadesi Geçmiş Borçlar, e-Tebligat notices and e-Beyan return counts from Dijital Vergi Dairesi with one API call each. A workflow can check the overdue debts every weekday morning and post each new e-Tebligat to your team's system.

Page: https://fous.com/automate/dijital-vergi-dairesi
Updated: 2026-11-12

Works with your own Dijital Vergi Dairesi account. Fous is an independent product.

## What you can build on Dijital Vergi Dairesi

### Get tax debts

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

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

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](/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.

### Overdue tax debts, every weekday morning

Starts: Every weekday at 8:00, Europe/Istanbul

1. Get the tax debts, overdue only, from Dijital Vergi Dairesi.
2. Stop when Vadesi Geçmiş Borçlar is zero.
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

Starts: Every day at 9:00, Europe/Istanbul

1. List the e-Tebligat notices received in the last 7 days.
2. Keep the notices that were not there on the last run.
3. Post each one, with its date received, sender and subject, to your Slack or document system webhook.

### Weekly e-Beyan return check

Starts: Every Monday at 8:30, Europe/Istanbul

1. Count the e-Beyan returns by status.
2. Stop when Hatalı and Onay Bekleyen Beyannameler are both zero.
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](/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 tax debts” 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": "dijital.gib.gov.tr/get_tax_debts",
    "input": {
      "overdue_only": false
    }
  }'
```

Example response:

```
{
  "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.

| Option | What it covers | What it takes |
| --- | --- | --- |
| e-Beyan REST API (Entegratör Portalı) | Sends returns; its developer guides list Banka, Sigorta, KDV1 and Damga Beyannamesi. Pre-Prod, Pilot and Prod environments. | An intermediary or legal entity with e-beyanname authority, an approved application with fixed IP addresses, and a Bearer token for each environment. |
| GİB mobile app | Debts across taxes and fees, partial or full payment, receipts, e-Tebligat, Borç Durum Yazısı and Mükellefiyet Yazısı requests. | Nothing beyond a phone: it is used by hand. |
| Dijital Vergi Dairesi by hand | Debts on the Ana Sayfa and Borç Ödeme ve Detay, payment, e-Tebligat, Başvuru Formlarım, Sorgulamalar / Doğrulamalar and the e-Beyan application. | A password with your T.C. Kimlik No, Vergi Kimlik No or Kullanıcı Kodu, or an e-Devlet sign-in. |

Read on November 12, 2026: [e-Beyan Entegrasyon Kılavuzu (2025)](https://ebeyan.gib.gov.tr/entegrator/files/e-Beyan%20Entegrasyon%20K%C4%B1lavuzu.pdf), [GİB mobile app listing](https://apps.apple.com/tr/app/gi-b/id1351972062), [Dijital Vergi Dairesi](https://dijital.gib.gov.tr/).

## 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](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)
- [myAADE](https://fous.com/automate/myaade.md)
- [Portal das Finanças](https://fous.com/automate/portal-das-financas.md)
- [e-Beyanname](https://fous.com/automate/e-beyanname.md)

Other industries: [ePortal ESTV](/automate/eportal-estv), [Metrc](/automate/metrc), [NMLS](/automate/nmls), [TRACS / iMAX](/automate/tracs-imax), [Cal eProcure](/automate/cal-eprocure), [NCDOR eBusiness Center](/automate/ncdor-ebusiness-center).

## Frequently asked questions

### Does Dijital Vergi Dairesi have an API?

Only for sending returns. GİB's e-Beyan REST API is open to intermediaries and legal entities with e-beyanname authority after an approved e-Beyan Entegrasyon Başvurusu, with fixed IP addresses and a Bearer token. Debts, payments and e-Tebligat are used in the site or the GİB mobile app.

### How do I apply for e-Beyan API access?

In Dijital Vergi Dairesi, open Başvuru Formlarım, then e-Beyan Entegrasyon Başvurusu, and select Başvuru Oluştur. You fill in Mükellef Bilgileri with the environment and IP addresses, add an authorized and a technical contact, and confirm with an SMS code. The request then shows as İnceleme Bekleniyor until GİB decides.

### Where do I see what my company owes?

On the Ana Sayfa after signing in: Vadesi Geçmiş Borçlar, Vadesi Gelmemiş Borçlar and Toplam Borçlar. Selecting one opens Borç Ödeme ve Detay, where you can pick debts and pay them with Öde.

### Is Fous affiliated with Gelir İdaresi Başkanlığı?

No. Fous is an independent product. You use it with your own Dijital Vergi Dairesi account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Dijital Vergi Dairesi (Gelir İdaresi Başkanlığı). 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.