# Tek ülkenin kapsamı

`GET https://ulawk.com/api/katalog/{kod}/`

Tek ülkenin katalog kaydı. Bilinmeyen ya da henüz açılmamış ülke 404.

## Kimlik doğrulama

Anahtar gerekmez.

## Yol parametreleri

- `kod` (string, zorunlu) — ISO 3166-1 alfa-2 ülke kodu.

## Sorgu parametreleri

- `dil` (string) — Metinlerin dili.

## Yanıt

### 200 — Ülke kaydı.

- `kod` (string, zorunlu)
- `ad` (string, zorunlu)
- `bayrak` (string)
- `yerel_ad` (string)
- `bolge` (string)
- `bolge_ad` (string)
- `kademe` (string, zorunlu)
- `kademe_ad` (string)
- `hedef_kademe` (string, null)
- `beta` (boolean)
- `bekleyen` (boolean)
- `kaynak` (string) — Kaynağın genel adı.
- `kimlikler[]` (object[], zorunlu)
- `kimlikler[].ad` (string, zorunlu)
- `kimlikler[].bicim` (string, zorunlu)
- `kimlikler[].ornek` (string, zorunlu)
- `kimlikler[].kontrol` (string, zorunlu)
- `kimlikler[].aranabilir` (boolean, zorunlu)
- `kimlikler[].birincil` (boolean, zorunlu)
- `veri` (object, zorunlu)
- `belgeler[]` (object[], zorunlu)
- `yenileme` (object, zorunlu)
- `yenileme.sinif` (string, zorunlu)
- `yenileme.ad` (string, zorunlu)
- `izleme[]` (string[], zorunlu)
- `uyum_isaretleri[]` (object[])
- `uyum_ilkesi` (string)
- `yanit` (object, zorunlu)
- `yanit.sinif` (string, zorunlu)
- `yanit.ad` (string, zorunlu)
- `notlar[]` (string[], zorunlu)
- `surum` (string)

```json
{
  "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."
  ],
  "surum": "2026-10-16"
}
```

### 404 — Ülke bulunamadı.

- `hata` (string, zorunlu)
- `kod` (string)

```json
{
  "hata": "Ülke bulunamadı.",
  "kod": "XX"
}
```

## İstek

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