# Coverage catalogue

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

Coverage by country: identifiers, datapoints, documents, refresh and response time. Keyless, read-only, cached (Cache-Control). Only countries open to customers.

## Authentication

No key required.

## Query parameters

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

## Response

### 200 — Catalogue.

- `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) — Generic name of the source.
- `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": "en",
  "durumlar": {
    "var": "Yes",
    "kismi": "Partly",
    "ilan": "Rebuilt from notices",
    "istek": "On request",
    "yok": "No"
  },
  "veri_noktalari": {
    "kimlik": "Identity and status",
    "adres": "Registered address",
    "yetkili": "Officers",
    "ortak": "Shareholders",
    "gf": "Beneficial owners",
    "ilan": "Notices and changes",
    "finans": "Financial statements",
    "belge": "Official documents"
  },
  "yenileme_siniflari": {
    "gunluk": "Daily",
    "haftalik": "Weekly",
    "aylik": "Monthly",
    "olay": "As events occur"
  },
  "yanit_siniflari": {
    "anlik": "Instant",
    "dakikalar": "Within minutes",
    "is_gunu": "1–3 business days",
    "teklif": "On quote"
  },
  "uyelik": {
    "dahil": "Monitoring, profiles, daily alerts, sanctions screening and documents marked \"included\" are part of every plan; plans differ only in the number of companies monitored.",
    "istek": "On-request items are priced per company and document; where no price is listed we quote first and never order without your approval."
  },
  "ulke_sayisi": 42,
  "ulkeler": [
    {
      "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."
      ]
    }
  ]
}
```

## Request

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