# Kapsam kataloğu

`GET https://ulawk.com/api/katalog/`

Ülke ülke kapsam: kimlikler, veri noktaları, belgeler, yenileme ve yanıt süresi. Anahtarsız, salt okunur, önbellekli (Cache-Control). Yalnız müşteriye açık ülkeler.

## Kimlik doğrulama

Anahtar gerekmez.

## Sorgu parametreleri

- `dil` (string) — Metinlerin dili.

## Yanıt

### 200 — Katalog.

- `surum` (string, zorunlu)
- `dil` (string, zorunlu) Değerler: tr, en.
- `durumlar` (object, zorunlu)
- `veri_noktalari` (object, zorunlu)
- `yenileme_siniflari` (object, zorunlu)
- `yanit_siniflari` (object, zorunlu)
- `uyelik` (object, zorunlu)
- `uyelik.dahil` (string, zorunlu)
- `uyelik.istek` (string, zorunlu)
- `ulke_sayisi` (integer, zorunlu)
- `ulkeler[]` (KatalogUlke[], zorunlu)
- `ulkeler[].kod` (string, zorunlu)
- `ulkeler[].ad` (string, zorunlu)
- `ulkeler[].bayrak` (string)
- `ulkeler[].yerel_ad` (string)
- `ulkeler[].bolge` (string)
- `ulkeler[].bolge_ad` (string)
- `ulkeler[].kademe` (string, zorunlu)
- `ulkeler[].kademe_ad` (string)
- `ulkeler[].hedef_kademe` (string, null)
- `ulkeler[].beta` (boolean)
- `ulkeler[].bekleyen` (boolean)
- `ulkeler[].kaynak` (string) — Kaynağın genel adı.
- `ulkeler[].kimlikler[]` (object[], zorunlu)
- `ulkeler[].kimlikler[].ad` (string, zorunlu)
- `ulkeler[].kimlikler[].bicim` (string, zorunlu)
- `ulkeler[].kimlikler[].ornek` (string, zorunlu)
- `ulkeler[].kimlikler[].kontrol` (string, zorunlu)
- `ulkeler[].kimlikler[].aranabilir` (boolean, zorunlu)
- `ulkeler[].kimlikler[].birincil` (boolean, zorunlu)
- `ulkeler[].veri` (object, zorunlu)
- `ulkeler[].belgeler[]` (object[], zorunlu)
- `ulkeler[].yenileme` (object, zorunlu)
- `ulkeler[].yenileme.sinif` (string, zorunlu)
- `ulkeler[].yenileme.ad` (string, zorunlu)
- `ulkeler[].izleme[]` (string[], zorunlu)
- `ulkeler[].uyum_isaretleri[]` (object[])
- `ulkeler[].uyum_ilkesi` (string)
- `ulkeler[].yanit` (object, zorunlu)
- `ulkeler[].yanit.sinif` (string, zorunlu)
- `ulkeler[].yanit.ad` (string, zorunlu)
- `ulkeler[].notlar[]` (string[], zorunlu)
- `ulkeler[].surum` (string)

```json
{
  "surum": "2026-10-16",
  "dil": "tr",
  "durumlar": {
    "var": "Var",
    "kismi": "Kısmi",
    "ilan": "İlanlardan kurulur",
    "istek": "İstek üzerine",
    "yok": "Yok"
  },
  "veri_noktalari": {
    "kimlik": "Kimlik ve durum",
    "adres": "Kayıtlı adres",
    "yetkili": "Yetkililer",
    "ortak": "Ortaklar",
    "gf": "Gerçek faydalanıcı",
    "ilan": "İlanlar ve değişiklikler",
    "finans": "Mali tablolar",
    "belge": "Resmî belgeler"
  },
  "yenileme_siniflari": {
    "gunluk": "Günlük",
    "haftalik": "Haftalık",
    "aylik": "Aylık",
    "olay": "Olay oldukça"
  },
  "yanit_siniflari": {
    "anlik": "Anlık",
    "dakikalar": "Dakikalar içinde",
    "is_gunu": "1–3 iş günü",
    "teklif": "Teklif ile"
  },
  "uyelik": {
    "dahil": "Takip, profil, günlük uyarılar, yaptırım taraması ve \"üyeliğe dahil\" belgeler her planda dahildir; planlar yalnız takip edilen şirket sayısına göre ayrılır.",
    "istek": "İstek üzerine kalemler şirket ve belge başına fiyatlanır; fiyatı yazmayanlar için önce fiyat bildirilir, onayınız olmadan sipariş verilmez."
  },
  "ulke_sayisi": 42,
  "ulkeler": [
    {
      "kod": "TR",
      "ad": "Türkiye",
      "bayrak": "🇹🇷",
      "yerel_ad": "Türkiye",
      "bolge": "tr",
      "bolge_ad": "Türkiye",
      "kademe": "tam",
      "kademe_ad": "Tam kapsam",
      "hedef_kademe": "tam",
      "beta": false,
      "bekleyen": false,
      "kaynak": "Türkiye Ticaret Sicili Gazetesi + KAP",
      "kimlikler": [
        {
          "ad": "Ticaret sicil numarası",
          "bicim": "Ticaret sicili müdürlüğü + sicil numarası; aynı numara başka müdürlükte başka şirkettir",
          "ornek": "412907-5",
          "kontrol": "",
          "aranabilir": true,
          "birincil": true
        },
        {
          "ad": "Ticaret sicili müdürlüğü",
          "bicim": "İl ya da ilçe ticaret sicili müdürlüğünün adı",
          "ornek": "İstanbul",
          "kontrol": "",
          "aranabilir": true,
          "birincil": false
        }
      ],
      "veri": {
        "kimlik": {
          "durum": "var",
          "etiket": "Var",
          "not": "Unvan, tür, sicil müdürlüğü ve numarası, kuruluş ve durum Ticaret Sicili Gazetesi ilanlarından."
        },
        "adres": {
          "durum": "var",
          "etiket": "Var",
          "not": "Merkez adresi ve adres değişiklikleri ilanlardan."
        },
        "yetkili": {
          "durum": "var",
          "etiket": "Var",
          "not": "Yönetim kurulu, müdürler, görev süreleri, temsil ve imza yetkileri."
        },
        "ortak": {
          "durum": "ilan",
          "etiket": "İlanlardan kurulur",
          "not": "Kuruluş, sermaye ve pay devri ilanlarından kurulur. Anonim şirketlerde pay defteri şirkette tutulur; tam dağılım ilan edilmemişse bu açıkça yazılır."
        },
        "gf": {
          "durum": "ilan",
          "etiket": "İlanlardan kurulur",
          "not": "Gazetedeki pay dağılımından doğrudan ve dolaylı %25 eşiğiyle hesaplanır; belirlenemezse üst düzey yönetici gösterilir."
        },
        "ilan": {
          "durum": "var",
          "etiket": "Var",
          "not": "Kuruluştan bugüne Ticaret Sicili Gazetesi ilanları; borsada işlem görenlerde KAP bildirimleri."
        },
        "finans": {
          "durum": "kismi",
          "etiket": "Kısmi",
          "not": "Yalnız KAP'ta finansal rapor yayımlayan şirketler."
        },
        "belge": {
          "durum": "var",
          "etiket": "Var",
          "not": "Gazete ilan sayfaları (PDF), her bilgi kaynağıyla."
        }
      },
      "belgeler": [
        {
          "tur": "ilan_tr",
          "ad": "Ticaret Sicili Gazetesi ilan sayfası (PDF)",
          "yerel_ad": "",
          "dahil": true,
          "istek_uzerine": false,
          "elle": false,
          "teslim": {
            "sinif": "anlik",
            "ad": "Anlık"
          },
          "not": "",
          "fiyat": null
        },
        {
          "tur": "kap",
          "ad": "KAP bildirimleri",
          "yerel_ad": "",
          "dahil": true,
          "istek_uzerine": false,
          "elle": false,
          "teslim": {
            "sinif": "anlik",
            "ad": "Anlık"
          },
          "not": "Borsada işlem gören şirketler.",
          "fiyat": null
        }
      ],
      "yenileme": {
        "sinif": "gunluk",
        "ad": "Günlük"
      },
      "izleme": [
        "Yönetim kurulu ve müdür değişiklikleri",
        "Temsil ve imza yetkisi"
      ],
      "uyum_isaretleri": [
        {
          "anahtar": "yk_suresi_dolmus",
          "ad": "Yönetim kurulunun görev süresi dolmuş görünüyor",
          "aciklama": "TTK m.362/1"
        },
        {
          "anahtar": "mudur_suresi_dolmus",
          "ad": "Müdürlerin görev süresi dolmuş görünüyor",
          "aciklama": "TTK m.623 vd."
        }
      ],
      "uyum_ilkesi": "Yalnız kaynak açıkça söylüyorsa işaretlenir; işaretin olmaması \"temiz\" anlamına gelmez.",
      "yanit": {
        "sinif": "dakikalar",
        "ad": "Dakikalar içinde"
      },
      "notlar": [
        "Ticaret Sicili Gazetesi kuruluştan bugüne, KAP bildirimleri ve orijinal gazete PDF'leri; ortaklar ve gerçek faydalanıcılar ilanlardan kurulur."
      ]
    }
  ]
}
```

## İstek

```bash
curl "https://ulawk.com/api/katalog/"
```