Bilgi Kütüphanesi Şirket Listesi

Bazı Bilgi Kütüphanesi kayıtları tek bir duyuru değil, kurumun düzenli olarak güncellediği bir şirket listesidir — bugün TMSF'nin "Kayyım Olunan Şirketler" listesi (ticaret sicildeki unvan, vergi kimlik numarası, ticaret sicil müdürlüğü). Bu uç nokta böyle bir kaydı satır satır döner ve her güncellemede listeye eklenen, listeden çıkarılan ve bilgisi değişen şirketleri gösterir.

Bir kaydın şirket listesi olup olmadığını Bilgi Kütüphanesi Detayı söyler: presentation alanı "companyList" ise bu uç noktayı çağırın.

Parametre

• id — kayıt ID'si (browse yanıtındaki id).

Yanıt

{
  "recordId": "3c8e2f1a-...",
  "readable": true,
  "listUpdatedOn": "2026-10-23",
  "rows": [
    { "title": "ÖRNEK İNŞAAT SANAYİ VE TİCARET ANONİM ŞİRKETİ", "taxNumber": "0012345678", "registryOffice": "İSTANBUL" },
    { "title": "DENEME YATIRIM LLC", "taxNumber": "0", "registryOffice": "" }
  ],
  "firstSeenAt": "2026-10-30T05:51:12+00:00",
  "firstListUpdatedOn": "2026-10-23",
  "firstCount": 1326,
  "history": [
    {
      "revisionNumber": 1,
      "detectedAt": "2026-11-06T05:50:40+00:00",
      "listUpdatedOnBefore": "2026-10-23",
      "listUpdatedOnAfter": "2026-11-06",
      "countBefore": 1326,
      "countAfter": 1327,
      "added": [ { "title": "ÖRNEK GIDA LİMİTED ŞİRKETİ", "taxNumber": "1234567890", "registryOffice": "ANKARA" } ],
      "removed": [],
      "changed": [
        {
          "before": { "title": "ÖRNEK ENERJİ ANONİM ŞİRKETİ", "taxNumber": "9876543210", "registryOffice": "İZMİR" },
          "after": { "title": "ÖRNEK ENERJİ VE MADENCİLİK ANONİM ŞİRKETİ", "taxNumber": "9876543210", "registryOffice": "İZMİR" }
        }
      ],
      "readable": true
    }
  ],
  "olderUpdateCount": 0
}

• recordId — sorduğunuz kayıt
• readable — kaydın metni şirket listesi olarak okunduysa true. false ise rows boş ve listUpdatedOn null döner (yanıt yine 200'dür); listeyi detayın plainText alanından ya da Belge İndirme ile kurumun kendi dosyasından okuyun
• listUpdatedOn — kurumun bildirdiği "son güncelleme" tarihi (yyyy-MM-dd, saatsiz); kurum tarih belirtmemişse null
• rows[] — listedeki her şirket: title (ticaret sicildeki unvanı), taxNumber (vergi kimlik numarası), registryOffice (ticaret sicil müdürlüğü; boş olabilir). Sıra unvana göredir (büyük/küçük harf ve Türkçe karakter farkı gözetilmeden), eşitlikte vergi numarası ve müdürlük
• firstSeenAt — kaydın Regvion'a ilk alındığı an
• firstListUpdatedOn, firstCount — taban: kayıt ilk alındığında listenin tarihi ve şirket sayısı; okunamazsa null
• history[] — güncellemeler, en yeniden eskiye, en çok 24 tane:
  • revisionNumber, detectedAt — güncellemenin sıra numarası ve Regvion'un onu saptadığı an
  • listUpdatedOnBefore / listUpdatedOnAfter — güncellemeden önceki ve sonraki listenin tarihi
  • countBefore / countAfter — önceki ve sonraki listenin şirket sayısı
  • added[] — listeye eklenen şirketler (rows[] ile aynı alanlar)
  • removed[] — listeden çıkarılan şirketler
  • changed[] — bilgisi değişen şirketler: before ve after (her biri rows[] ile aynı alanlar)
  • readable — güncellemenin iki tarafı da okunduysa true; false ise üç liste boştur, okunan tarafın sayısı ve tarihi dolu kalır (okunamayan taraf null)
• olderUpdateCount — history'de gösterilmeyen, daha eski güncelleme sayısı

Vergi kimlik numarası bir metindir

taxNumber her zaman bir JSON metnidir, sayı değildir: baştaki sıfırlar numaranın parçasıdır ("0012345678", "12345678" değildir). Değerler kurumun yayımladığı gibidir: tekil değildir (şubeler ana şirketin numarasını taşır), bazı satırlarda "0" ya da boş metindir ve bazıları 11 hanelidir. Sayıya çevirmeyin ve birincil anahtar olarak kullanmayın.

Bir değişiklik nasıl belirlenir

Önceki ve sonraki listedeki şirketler sırayla şöyle eşlenir:

1. Birebir aynı satırlar değişmemiştir.
2. Kalanlardan, iki listede de yalnız bir kez geçen bir vergi numarası (boş ya da "0" değil) aynı şirkettir — unvanı değişen şirket böyle changed'de görünür.
3. Hâlâ kalanlar unvanla (büyük/küçük harf ve Türkçe karakter farkı gözetilmeden, unvan iki tarafta da tekse) eşlenir — şubeler, vergi numarasız şirketler ve vergi numarası düzeltmeleri böyle changed'de görünür.
4. Eşlenmeyen önceki satırlar removed, sonraki satırlar added'dır.

Ortak vergi numaralı bir şubenin unvanı değişirse ne vergi numarası ne unvan eşler; şube removed ve added'da birlikte görünür.

Kurum listeyi değiştirmeden yalnız tarihini değiştirdiyse bu da bir güncellemedir: üç liste boş, listUpdatedOnBefore ile listUpdatedOnAfter farklıdır.

Geçmiş, saklanan liste sürümlerinden her istekte yeniden hesaplanır (önbellek yoktur; yeni bir güncelleme bir sonraki istekte görünür). En yeni 24 güncellemenin ayrıntısı döner; daha eskileri yalnız olderUpdateCount ile sayılır. Taban (firstListUpdatedOn, firstCount) her zaman kaydın ilk alındığı andaki listedir.

Kütüphaneye özel kayıt

Şirket listesi kayıtları yalnız kütüphanede görüntülenir (detayda isLibraryOnly: true): ne ilk alımda ne sonraki değişikliklerde bildirim, e-posta, webhook ya da "İlgili Mevzuat" eşleşmesi üretilir; kayıt hiçbir takip kuralı ya da izleme listesiyle eşleşmez ve yapay zeka ile işlenmez. Listedeki değişiklikleri izlemek için bu uç noktayı düzenli aralıklarla çağırın — TMSF listesi Regvion'da günde iki kez denetlenir.

Ne sıklıkla çağırmalı

Liste Regvion'da günde iki kez denetlenir; uç noktayı günde birkaç kezden sık çağırmanın bir yararı yoktur (her çağrı kotanızdan düşer). Yeni bir güncelleme olup olmadığını history[0].revisionNumber ile anlayın: bir önceki çağrıdakiyle aynıysa liste de değişmemiştir; history boşsa liste ilk alındığından beri değişmemiştir. Yalnız değer değiştiğinde satırları yeniden işleyin.

data: null bir hata değildir

Kayıt bir şirket listesi değilse yanıt 200 ve data: null döner (detaydaki presentation bu kayıtta null'dır).

404 — kayıt bulunamadı.

Yetki

Api.InformativeLibrary.Detail iznini gerektirir ve detay uç noktasıyla aynı kota kovasından düşer. Ayrı bir izin tanımlanması gerekmez.