Enum Referansı

API'nin filtre parametreleri ve yanıt alanlarında kullanılan tüm enum'ların tam değer-isim eşlemesi. Etiket enum'ları (InstitutionType, DepartmentType, TopicType) sayı olarak gönderilir; aksiyon, ciddiyet ve son tarih türü gibi enum'lar isim string'i olarak gönderilir, yanıtlarda sayı olarak döner.

Hızlı Tablo — Hangi Enum, Nasıl Gönderilir, Nasıl Döner

Enum	İstekte (filtre)	Yanıtta
InstitutionType	sayı (?institutionTypes=1)	sayı dizisi (*)
DepartmentType	sayı (?departments=1)	sayı dizisi (*)
TopicType	sayı (?topics=1)	sayı dizisi (*)
ObligationActionType	isim (?actionTypes=Report)	sayı
ObligationSeverity	isim (?severityMin=High)	sayı — ancak /library/{id} ve /library/{id}/obligations içinde enum ismi string'i, değer atanmamışsa null
DeadlineKind	(filtre yok)	sayı
DocumentFormat	(filtre yok)	sayı
files[].kind / role / status	(filtre yok)	isim string'i (camelCase) — yalnız /library/{id}

(*) İstisna: /library uçlarının tamamı (/library, /library/semantic, /library/{id} ve /library/digest) etiket dizilerini insan-okunabilir Türkçe etiket string'i olarak döner (örn. ["Banka", "Ödeme Kuruluşu"]), sayı dizisi olarak değil; /library/digest bunlardan yalnızca institutionTypes alanını taşır. Sayı dizisi dönen uçlar: /obligations/{id} üç etiket dizisini de (institutionTypeIds, departmentIds, topicIds), /obligations/search, /obligations/upcoming, /documents/{id} ve /documents/{id}/obligations yalnızca departmentIds'i, /subscriptions/profile ise institutionTypes / topics alanlarını döndürür. /library/{id}/obligations hiç etiket dizisi döndürmez — bu uç noktanın yükümlülük nesnesinde institutionTypes / departments / topics alanları yoktur; etiket kimlikleri gerekiyorsa yükümlülüğün id'si ile /obligations/{id}'ye gidin. /library/{id} ve /library/{id}/obligations uçlarında severity alanı da sayı değil, enum ismi string'idir.

---

InstitutionType — Kurum Tipleri

Yükümlü taraf — etkilenen finansal kuruluş kategorisi.

ID	Enum İsmi	Açıklama
1	Banka	Mevduat bankaları (klasik bankacılık)
2	KatilimBankasi	Katılım bankaları (faizsiz)
3	FinansalKiralamaSirketi	Finansal kiralama (leasing) şirketleri
4	FaktoringSirketi	Faktoring şirketleri
5	FinansmanSirketi	Finansman şirketleri (tüketici/taşıt)
6	TasarrufFinansmanSirketi	Tasarrufa dayalı faizsiz finansman
7	VarlikYonetimSirketi	Varlık yönetim şirketleri
8	OdemeKurulusu	Ödeme hizmetleri sağlayıcıları
9	ElektronikParaKurulusu	Elektronik para kuruluşları
10	AraciKurum	SPK aracı kurumlar (SermayePiyasasiKurulusu yerine)
11	PortfoyYonetimSirketi	Portföy yönetim şirketleri
12	YatirimFonu	Yatırım ve menkul kıymet fonları
13	KriptoVarlikHizmetSaglayici	Kripto varlık hizmet sağlayıcılar
14	SigortaSirketi	Sigorta şirketleri
15	ReasuransSirketi	Reasürans şirketleri
16	EmeklilikSirketi	Emeklilik şirketleri
17	GayrimenkulDegerlemeSirketi	Gayrimenkul değerleme şirketleri
18	BagimsizDenetimKurulusu	Bağımsız denetim kuruluşları
19	FinansalHolding	Finansal holding şirketleri (eskiden Fintech)
20	TumFinansalKuruluslar	Tüm finansal kuruluşlara uygulanan yatay düzenlemeler
21	TumKamuSermayeliFinansalKuruluslar	Tüm kamu sermayeli finansal kuruluşlar
22	KalkinmaVeYatirimBankasi	Kalkınma ve yatırım bankaları (5411 sayılı Kanun md. 3)
23	DijitalBankaMevduat	Dijital banka (mevduat) — üst etiketi Banka (1). Genel bankacılık düzenlemelerinde Banka ile birlikte gelir; yalnız dijital bankaya özgü düzenlemede tek başına, yalnız şube işlemlerinde hiç gelmez
24	DijitalBankaKatilim	Dijital banka (katılım) — üst etiketi KatilimBankasi (2); aynı kurallar KatilimBankasi ile

---

DepartmentType — Departmanlar

Yükümlülüğü hayata geçirmesi beklenen iç birim.

ID	Enum İsmi	Departman
1	Uyum	Uyum (Compliance)
2	IcDenetim	İç Denetim
3	IcKontrol	İç Kontrol
4	Hukuk	Hukuk
5	RiskYonetimi	Risk Yönetimi
6	FinansalRaporlama	Finansal Raporlama (eskiden Finans)
7	MuhasebeVergi	Muhasebe & Vergi
8	Hazine	Hazine
9	KrediTahsis	Kredi Tahsis (eskiden Kredi)
10	Operasyon	Operasyon
11	BilgiTeknolojileri	Bilgi Teknolojileri
12	BilgiGuvenligi	Bilgi Güvenliği
13	VeriKoruma	Veri Koruma (KVKK)
14	OdemeSistemleri	Ödeme Sistemleri
15	SatinAlmaIdari	Satın Alma & İdari (eskiden SatinAlma)
16	PazarlamaUrun	Pazarlama & Ürün (Pazarlama+Ürün birleşti)
17	BireyselPerakende	Bireysel & Perakende Bankacılık
18	KurumsalTicari	Kurumsal & Ticari Bankacılık
19	MusteriDeneyimi	Müşteri Deneyimi & Şikayet Yönetimi
20	InsanKaynaklari	İnsan Kaynakları
21	KurumsalIletisim	Kurumsal İletişim
22	YatirimciIliskileri	Yatırımcı İlişkileri
23	SurdurulebilirlikESG	Sürdürülebilirlik & ESG
24	StratejiIsGelistirme	Strateji & İş Geliştirme (eskiden Strateji)

---

TopicType — Konular

Düzenleyici çerçevenin konu başlığı.

ID	Enum İsmi	Konu
1	AmlCft	AML / CFT (Aklama ve Terörün Finansmanı ile Mücadele)
2	IhtiyatiDuzenleme	İhtiyati düzenleme
3	SermayeYeterliligi	Sermaye yeterliliği
4	LikiditeYonetimi	Likidite yönetimi (eskiden Likidite)
5	DuzenleyiciRaporlama	Düzenleyici raporlama (eskiden Raporlama)
6	KamuyuAydinlatma	Kamuyu aydınlatma
7	TuketiciKoruma	Tüketici koruma
8	VeriGizliligi	Veri gizliliği (KVKK)
9	SiberGuvenlik	Siber güvenlik
10	DisKaynakKullanimi	Dış kaynak kullanımı
11	KurumsalYonetim	Kurumsal yönetim
12	RiskYonetimi	Risk yönetimi
13	OdemeSistemleri	Ödeme sistemleri
14	AcikBankacilik	Açık bankacılık (Open Banking)
15	KriptoDijitalVarliklar	Kripto & dijital varlıklar (eskiden Kripto)
16	VergiMevzuati	Vergi mevzuatı (eskiden Vergi)
17	MuhasebeStandartlari	Muhasebe standartları (eskiden Muhasebe)
18	Denetim	Denetim
19	RekabetHukuku	Rekabet hukuku (eskiden Rekabet)
20	ESGSurdurulebilirFinans	ESG & sürdürülebilir finans
21	YaptirimlarUlkeRiski	Yaptırımlar & ülke riski
22	OperasyonelDayaniklilik	Operasyonel dayanıklılık (DORA-eşdeğeri)
23	PiyasaButunlugu	Piyasa bütünlüğü
24	IstihdamIsHukuku	İstihdam & iş hukuku
25	FintechDijitalFinansYZ	Fintech, dijital finans & yapay zekâ

---

ObligationActionType — Yükümlülük Aksiyon Tipi

Yükümlülüğün doğasındaki temel aksiyon. İstek filtrelerinde enum ismi olarak gönderilir (?actionTypes=Report); yanıtlarda sayı döner.

ID	Enum İsmi	Açıklama
0	Other	Yukarıdakilerin hiçbirine tam uymayan
1	Report	Bildirim/raporlama (regülatöre veya iç organa)
2	Implement	Süreç/sistem kurma veya değiştirme
3	Prohibit	Belirli bir davranışın yasaklanması
4	Document	Belgeleme / evrak tutma yükümlülüğü
5	FileRecord	Sicil veya kayıt tutma
6	Train	Personel eğitimi
7	UpdatePolicy	Politika veya sözleşme güncelleme
8	NotifyCustomer	Müşteriye yönelik bildirim

---

ObligationSeverity — Ciddiyet

Yükümlülüğün regülatif risk düzeyi. İstekte enum ismi (?severityMin=High); yanıtta sayı.

ID	Enum İsmi	Açıklama
1	Low	Bilgilendirici, ihlal halinde önemli yaptırım yok
2	Medium	Standart denetim bulgusu seviyesinde
3	High	Para cezası veya operasyonel kısıtlama riski
4	Critical	Lisans iptali, faaliyet durdurma veya yüksek miktarlı ceza riski

severityMin parametresi bu seviyede ve üzerini filtreler — severityMin=High hem High hem Critical döner.

---

DeadlineKind — Son Tarih Türü

Yanıtta deadlineKind alanı bu enum'un sayı değerini taşır. Filtreleme için doğrudan parametre yok; tarih aralığı için deadlineAfter / deadlineBefore, son tarihi olan-olmayan ayrımı için hasDeadline=true|false kullanın.

ID	Enum İsmi	Açıklama
0	None	Son tarih belirtilmemiş
1	Explicit	Mevzuatta kesin tarih (örn. "31.12.2026 tarihine kadar")
2	Relative	Bir olaya göreli süre (örn. "yayım tarihinden 90 gün sonra")
3	Conditional	Tetikleyici olaya bağlı (örn. "şüpheli işlem tespitinde")
4	Unclear	Mevzuatta geçiyor ama net değil (AI açıkladı, insan teyidi bekleniyor)

---

DocumentFormat — Doküman Formatı

Belgenin metninin hangi yoldan çıkarıldığını (çıkarım yolunu) belirtir. Biçim kaydedilen dosyanın baytlarından tanınır: Word belgeleri (.doc, .docx, .rtf), zip paketleri ve tablo dosyaları (.xls, .xlsx) 2026-10'dan bu yana kendi değerlerini (4–6) taşır. Bu değerler eklenmeden önce olduğu gibi saklanmış bazı eski Office veya arşiv dosyaları (.doc, .xls, .docx, .ppt, .zip) hâlâ 1 = Pdf olarak işaretli olabilir; Mevzuat Kütüphanesinde bu kayıtlar yeniden işlendikçe düzelir. Örnek: Bilgi Kütüphanesinde TBB'nin 2000-2012 dönemi ekleri. Yalnızca yanıtta görünür. Yeni değerler yalnızca sona eklenir, mevcut sayılar değişmez: istemcinizde tanımadığınız bir sayıyı hata saymayın.

ID	Enum İsmi	Açıklama
0	Html	HTML sayfa (örn. Resmi Gazete web fihristi)
1	Pdf	PDF yolu: genellikle PDF dosyası; 4–6 değerleri eklenmeden önce olduğu gibi saklanan bazı eski Office/arşiv dosyaları da bu değeri taşıyabilir
2	Image	Tek görsel (taranmış belge — OCR gerekmiş)
3	Mixed	Karma format (HTML + gömülü PDF/görsel)
4	Word	Word belgesi (.doc, .docx, .rtf) — tür dosyanın imzasından okunur
5	Archive	Zip paketi — birden çok dosya tek belge olarak yayımlanmış; dosyalar /library/{id} yanıtının files[] alanında
6	Spreadsheet	Tablo dosyası (.xls, .xlsx) — metni çıkarılmaz, yalnız indirilebilir

Dosyanın gerçek türüne göre işlem yapacaksanız (örn. PDF görüntüleyicide açmak veya PDF saymak) format alanına güvenmeyin. Bilgi Kütüphanesi uç noktaları (listeleme, detay, anlamlı arama) kaydedilmiş dosyanın MIME türünü contentType alanında döner. Bilgi Kütüphanesi Belge İndirme yanıtının Content-Type başlığı da aynı türü taşır. Mevzuat belgelerinde Doküman İndir yanıtının Content-Type başlığı ve dosya adı uzantısı dosyanın gerçek türünü taşır.

Paket dosyası alanları — kind, role, status

Zip paketi olan belgelerde GET /library/{id} yanıtındaki files[] öğeleri bu üç alanı camelCase isim string'i olarak taşır (sayı değil).

kind — dosyanın türü:

Değer	Açıklama
pdf	PDF
word	Word belgesi (.doc, .docx)
rtf	RTF belgesi
html	HTML sayfası
text	Düz metin
spreadsheet	Tablo (ör. .xls, .xlsx)
image	Görüntü
archive	Paket içindeki ikinci bir zip (açılmaz)
other	Diğer

role — dosyanın paketteki yeri (kural tabanlıdır; liste bu sırayla gelir):

Değer	Açıklama
main	Ana metin — mevzuatın kendisi
supplement	Ek: açıklama, üst yazı, liste, cetvel ve diğer belgeler
form	Form / şablon (ör. manyetik ortam şablonu, örnek veri)
downloadOnly	Yalnız indirilebilir: metni çıkarılmayan dosyalar (tablo, görüntü, iç içe zip, diğer)

status — dosyanın işlenme durumu:

Değer	Açıklama
extracted	Metni çıkarıldı
reusedText	Dosya bir önceki işlemeden beri değişmediği için metni yeniden kullanıldı
downloadOnly	Metni çıkarılmaz; yalnız indirilebilir
encrypted	Şifreli; açılamadı. Tek başına indirilemez — paketin tamamını indirin
skippedLimit	Paket sınırları (dosya sayısı, boyut, süre ya da metin hacmi) nedeniyle işlenmedi; indirilebilir
skippedRatio	Olağandışı sıkıştırma oranı (zip bombası şüphesi); açılmadı. Tek başına indirilemez
failed	Okunamadı (bozuk dosya); indirilebilir

---

CaseLawItemType — Emsal Karar Külliyatı

Emsal karar uç noktalarında (/court-decisions, /court-decisions/{id}, /court-decisions/semantic) kararın hangi külliyattan geldiğini belirtir. /court-decisions üzerinde itemType sorgu parametresi olarak sayı değeriyle gönderilir.

Tanımsız bir sayı gönderirseniz istek hata vermez — filtre sessizce uygulanmaz ve tüm külliyatlar döner. Değeri göndermeden önce bu tablodan doğrulayın.

Yanıtta hem sayı (itemType) hem de Türkçe etiketi (itemTypeLabel) birlikte döner.

ID	Enum İsmi	itemTypeLabel
0	YargitayKarari	Yargıtay
1	DanistayKarar	Danıştay
2	YerelHukuk	Yerel Hukuk Mahkemesi
3	IstinafHukuk	İstinaf Hukuk Dairesi
4	Kyb	Kanun Yararına Bozma
5	Uyusmazlik	Uyuşmazlık Mahkemesi
6	Anayasa	Anayasa Mahkemesi
7	Aihm	AİHM

---

CaseLawTextStatus — Emsal Karar Metin Durumu

Kararın tam metninin (Tam Metin) alınıp alınmadığını gösterir. Yalnızca yanıtta görünür; filtre parametresi yoktur. Yanıtta sayı (textStatus), Türkçe etiket (textStatusLabel) ve pratik kullanım için hasText boolean alanı birlikte döner — hasText, yalnızca textStatus = 1 olduğunda true'dur.

ID	Enum İsmi	textStatusLabel	Açıklama
0	Pending	Özet	Yapılandırılmış künye var; tam metin henüz alınmadı
1	Fetched	Tam Metin	Tam metin mevcut (hasText: true)
2	Failed	Alınamadı	Kaynaktan alınamadı (yeniden deneme bütçesi tükendi)
3	Skipped	Atlandı	Bilinçli olarak atlandı (metne dönüştürülemeyen içerik)

---

Pratik İpuçları

• Çoklu değer: obligations/search parametreleri (institutionTypes, departments, topics, actionTypes) dizi alır. Aynı parametreyi tekrar edin: ?topics=1&topics=8&topics=22.
• Kütüphane uçlarında parametre adları farklıdır: yukarıdaki tablodaki çoğul adlar yalnızca obligations/search içindir. /library ve /library/semantic her etiket türü için tekil ve tek değerli parametre alır (?institutionType=1&topic=8&department=3) — bu uçlarda çoklu değer desteklenmez. /library/digest ise virgülle ayrılmış liste bekler (?institutionType=1,20).
• Etkin tag arayan istekler: Etiket filtreleri tam eşleşme çalışır — bir yükümlülüğün bir tag setinde herhangi bir değer eşleşmesi yeterlidir (OR mantığı). Departman ve konu enum ID'lerini birleştirerek geniş ağ atın.
• TumFinansalKuruluslar (ID 20) tüm finansal sektörü ilgilendiren yatay düzenlemeler için kullanılan bir etikettir, joker değildir: her yerde diğer değerler gibi kesişimle eşleşir. Abonelik profilinde ya da bir takip kuralında 20 değeri yalnızca 20 ile etiketlenmiş yükümlülüklerle eşleşir; kurum tipi etiketi taşıyan her yükümlülükle değil. Seçilen diğer değerler kendi etiketleriyle eşleşmeye devam eder. Mevzuat Bülteni, profil süzgeci açıkken profildeki kurum tiplerine 20'yi kendiliğinden ekler (yatay düzenlemeler görünsün diye). API filtrelerinde (/obligations/search?institutionTypes=…) böyle bir ekleme yapılmaz — yatay düzenlemeleri de görmek istiyorsanız 20'yi filtre değerlerinize açıkça ekleyin: ?institutionTypes=1&institutionTypes=20.
• Sayı tabanlı etiket filtrelerinde geçersiz değer sessizce atlanır: ?institutionTypes=999 istekte 400 dönmez; sadece eşleşen sonuç olmaz. Aynısı departments ve topics için de geçerlidir.
• actionTypes böyle DEĞİLDİR: tanınmayan bir enum ismi (?actionTypes=NotARealValue) filtreyi yok saymaz, isteğin tamamını 500 / INTERNAL_ERROR ile düşürür. Yalnızca yukarıdaki tabloda listelenen enum isimlerini gönderin: Other, Report, Implement, Prohibit, Document, FileRecord, Train, UpdatePolicy, NotifyCustomer.
• severityMin için tanınmayan bir değer yok sayılır — filtre hiç uygulanmaz, yani beklediğinizden geniş bir sonuç kümesi dönebilir.