# Coverage of one country

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

Catalogue entry of one country. Unknown or not yet open: 404.

## Authentication

No key required.

## Path parameters

- `kod` (string, required) — ISO 3166-1 alpha-2 code.

## Query parameters

- `dil` (string) — Language of the texts.

## Response

### 200 — Country entry.

- `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) — Generic name of the source.
- `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": "Full coverage",
  "hedef_kademe": "tam",
  "beta": false,
  "bekleyen": false,
  "kaynak": "Turkish Trade Registry Gazette + KAP",
  "kimlikler": [
    {
      "ad": "Trade registry number",
      "bicim": "Registry office + registry number; the same number at another office is a different company",
      "ornek": "412907-5",
      "kontrol": "",
      "aranabilir": true,
      "birincil": true
    },
    {
      "ad": "Trade registry office",
      "bicim": "Name of the provincial or district trade registry office",
      "ornek": "İstanbul",
      "kontrol": "",
      "aranabilir": true,
      "birincil": false
    }
  ],
  "veri": {
    "kimlik": {
      "durum": "var",
      "etiket": "Yes",
      "not": "Name, type, registry office and number, incorporation and status from Trade Registry Gazette notices."
    },
    "adres": {
      "durum": "var",
      "etiket": "Yes",
      "not": "Head office address and address changes from the notices."
    },
    "yetkili": {
      "durum": "var",
      "etiket": "Yes",
      "not": "Board members, managers, terms of office, representation and signing authority."
    },
    "ortak": {
      "durum": "ilan",
      "etiket": "Rebuilt from notices",
      "not": "Rebuilt from incorporation, capital and share transfer notices. Joint-stock companies keep their share ledger themselves; when the full split is not published this is stated."
    },
    "gf": {
      "durum": "ilan",
      "etiket": "Rebuilt from notices",
      "not": "Calculated from the published shareholding with a direct and indirect 25% threshold; otherwise the senior managing official is shown."
    },
    "ilan": {
      "durum": "var",
      "etiket": "Yes",
      "not": "Trade Registry Gazette notices since incorporation; KAP disclosures for listed companies."
    },
    "finans": {
      "durum": "kismi",
      "etiket": "Partly",
      "not": "Only companies publishing financial reports on KAP."
    },
    "belge": {
      "durum": "var",
      "etiket": "Yes",
      "not": "Gazette notice pages (PDF), every item with its source."
    }
  },
  "belgeler": [
    {
      "tur": "ilan_tr",
      "ad": "Trade Registry Gazette notice page (PDF)",
      "yerel_ad": "",
      "dahil": true,
      "istek_uzerine": false,
      "elle": false,
      "teslim": {
        "sinif": "anlik",
        "ad": "Instant"
      },
      "not": "",
      "fiyat": null
    },
    {
      "tur": "kap",
      "ad": "KAP disclosures",
      "yerel_ad": "",
      "dahil": true,
      "istek_uzerine": false,
      "elle": false,
      "teslim": {
        "sinif": "anlik",
        "ad": "Instant"
      },
      "not": "Listed companies.",
      "fiyat": null
    }
  ],
  "yenileme": {
    "sinif": "gunluk",
    "ad": "Daily"
  },
  "izleme": [
    "Board and manager changes",
    "Representation and signing authority"
  ],
  "uyum_isaretleri": [
    {
      "anahtar": "yk_suresi_dolmus",
      "ad": "Board term appears to have expired",
      "aciklama": "TTK m.362/1"
    },
    {
      "anahtar": "mudur_suresi_dolmus",
      "ad": "Managers’ term appears to have expired",
      "aciklama": "TTK m.623 vd."
    }
  ],
  "uyum_ilkesi": "Flagged only when the source says so explicitly; no flag does not mean \"clear\".",
  "yanit": {
    "sinif": "dakikalar",
    "ad": "Within minutes"
  },
  "notlar": [
    "Trade Registry Gazette from incorporation to today, KAP disclosures and original gazette PDFs; shareholders and beneficial owners rebuilt from the notices."
  ],
  "surum": "2026-10-16"
}
```

### 404 — Country not found.

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

```json
{
  "hata": "Country not found.",
  "kod": "XX"
}
```

## Request

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