Herkese Açık Mevzuat Arşivi
GET https://api.mevzuatradar.com/api/v1/public/regulations
Kimlik doğrulama gerektirmez. Mevzuat başlığı, kısa özet, kaynak bilgisi ve
uygun bağlantıları döndürür. Tam metin ve kuruma özel alanlar döndürülmez.
Cache-Control: private, no-store uygulanır.
Sorgu Parametreleri
Bütün parametreler isteğe bağlıdır.
| Parametre | Tip ve sınır | Davranış |
|---|---|---|
page | Tam sayı, en az 1 | Varsayılan 1 |
limit | Tam sayı, en az 1 | Varsayılan 10; 20 üzeri değerler doğrulamadan önce 20 ile sınırlanır |
sourceType | SourceType enum | Büyük harfli kaynak türü; örn. GIB |
source | SourceType enum | sourceType karşılığı; ikisi verilirse source kullanılır |
sourceCode | Metin, en fazla 64 karakter | Kaynak koduyla ek eşitlik filtresi |
sourceCategory | Metin, en fazla 64 karakter | Kaynak ana kategorisi; örn. OZELGE |
sourceCategories | Virgülle ayrılmış metin veya tekrarlanan parametre | En fazla 32 farklı kategori; her biri en fazla 64 karakter |
sourceSubcategory | Metin, en fazla 64 karakter | Alt kategoriyle eşitlik filtresi |
legalDocumentClass | Metin, en fazla 64 karakter | Belge sınıfıyla eşitlik filtresi; örn. HTML, OZELGE |
sourceType ve source büyük/küçük harfe duyarlıdır. Enum, 13 yerleşik kodun
yanında CUSTOM değerini de kabul eder; bu özel kayıtların görünürlük
kurallarını kaldırmaz. Kod listesi Resmi Kaynaklar
sayfasındadır.
Diğer kaynak filtrelerinde boşluklar temizlenir ve değerler büyük harfe
çevrilir. Boş değerler filtre oluşturmaz. Dolu değerlerde yalnız A-Z, 0-9,
_ ve - kabul edilir. Bu metin filtreleri kapalı bir enum kataloğuna göre
doğrulanmaz; biçimi geçerli ama eşleşmeyen kod boş liste döndürebilir.
sourceCategories virgülle ayrıştırılır ve yinelenen değerler ayıklanır.
Tekil sourceCategory ile çoklu liste birleştirilir; bu kategorilerden
herhangi biri eşleşebilir. ISG kategori kodu ISG_DUYURU olarak normalize
edilir. Diğer filtreler birlikte uygulanır. sourceCode ile kaynak türü
çelişirse biri diğerini geçersiz kılmaz; eşleşen kayıt bulunmayabilir.
sort, order, serbest metin araması, etki düzeyi ve tarih aralığı bu
endpointin sorgu sözleşmesinde yoktur. Bilinmeyen parametreler ve geçersiz
DTO değerleri HTTP 400, errorCode: "BAD_REQUEST" ile reddedilir.
curl 'https://api.mevzuatradar.com/api/v1/public/regulations?page=1&limit=1&sourceCode=GIB'
curl 'https://api.mevzuatradar.com/api/v1/public/regulations?source=GIB&sourceCategories=OZELGE,SIRKULER'Sıralama ve Sayfalama
Sıralama sabittir: publishedAt azalan, eşit tarihlerde
publicationDateAttestation artan, qualityPublishEligible azalan,
qualityGateStatus artan ve id azalan. Bu sıralama alanlarının tamamı yanıt
nesnesinde yayımlanmaz. Sonuçlar değişen veri üzerinde sayfa numarası ve
ofsetle alınır; sayfalar arasında sabit anlık görüntü garantisi yoktur.
API en fazla limit + 1 kayıt okuyarak sonraki sayfayı belirler; tüm sonuçlar
üzerinde kesin toplam sayımı yapmaz.
data alanı | Anlam |
|---|---|
items | En fazla limit güvenli kayıt |
page, limit | Uygulanan sayfa ve sayfa boyutu |
hasMore | Bir sonraki sayfa için ek kayıt bulunduğunu gösterir |
totalIsEstimated | hasMore ile aynı değerdir |
total | (page - 1) × limit + items.length; hasMore=true ise buna 1 eklenir |
totalPages | total=0 ise 0; ek kayıt varsa page + 1, yoksa page |
İstemci hasMore=false olana kadar ilerler. totalIsEstimated=true iken
total ve totalPages tüm arşivin büyüklüğü olarak gösterilmez. İlk sayfanın
ötesindeki boş sayfada da formül ofseti içerir; bu alanlardan küresel kesin
toplam çıkarılmaz.
Yanıt
Aşağıdaki örnek 24 Ekim 2026 tarihli kimliksiz GİB sorgusunda gözlenen yapıyı
ve bir kaydı gösterir. İçerik ve değerler zamanla değişebilir; total: 2
bu örnekte GİB arşivinin toplamı değildir.
{
"success": true,
"data": {
"items": [
{
"id": "cmv97qvfq0oyu3jsfass75bmw",
"title": "Gelir Vergisi Kanununun Mükerrer 20/D Maddesi Hükmünün Uygulanmasında Türkiye'de Yerleşmiş Sayılma Hususunun Tespiti",
"summary": "T.C. GELİR İDARESİ BAŞKANLIĞI İstanbul Defterdarlığı Gelir Kanunları Gelir ve Kurumlar Vergileri Grup Müdürlüğü Sayı : E-62030549-120-1372289 13.10.2026 Konu : Gelir Vergisi Kanununun Mükerrer 20/D…",
"sourceType": "GIB",
"sourceCode": "GIB",
"externalSourceId": "GIB:OZELGE:433:39058",
"externalRevision": "gib-updated:2026-10-15T10:50:55.475643",
"sourceCategory": "OZELGE",
"sourceCategoryLabel": "Özelge",
"sourceSubcategory": "193",
"sourceSubcategoryLabel": "193",
"legalDocumentClass": "OZELGE",
"legalDocumentClassLabel": "Özelge",
"sourceUrl": "https://gib.gov.tr/mevzuat/kanun/433/ozelge/39058",
"originalPdfUrl": null,
"officialNumber": "E-62030549-120-1372289",
"officialDate": "13.10.2026",
"publishedAt": "2026-10-13T00:00:00.000Z",
"impactLevel": "BILGILENDIRME",
"sectors": ["GENEL"]
}
],
"hasMore": true,
"total": 2,
"totalPages": 2,
"totalIsEstimated": true,
"page": 1,
"limit": 1
}
}Kayıt Alanları ve Görünürlük
| Alan | Tip ve açıklama |
|---|---|
id, title, summary | Metin; başlık ve özet gösterime hazırlanır; özet en fazla 200 karakterlik kesim ve gerekirse … içerir |
sourceType | Kaynak türü enum değeri |
sourceCode, externalSourceId, externalRevision | Metin veya null; kaynak kodu, dış kimlik ve revizyon |
sourceCategory, sourceSubcategory, legalDocumentClass | Metin veya null; sınıflandırma kodları |
sourceCategoryLabel, sourceSubcategoryLabel, legalDocumentClassLabel | Metin veya null; gösterim etiketleri |
sourceUrl | Normalize edilmiş metin; kullanılabilir kaynak yüzeyi yoksa boş olabilir |
originalPdfUrl | Metin veya null; uygun PDF bağlantısı, gerektiğinde kaynak URL’sinden çözülür |
officialNumber | Kaynak üst verisindeki belge numarası; yoksa null |
officialDate | Kaynak tarih metni; yoksa yayın tarihinin İstanbul saat diliminde gg.aa.yyyy karşılığı; ISO-8601 olacağı varsayılmaz |
publishedAt | ISO-8601 zaman damgası |
impactLevel | KRITIK, YUKSEK, ORTA veya BILGILENDIRME |
sectors | Sektör kodlarından oluşan dizi |
Sorgu yalnız isPrivate=false, ownerOrganizationId=null olan ve yayın tarihi
gelecekte olmayan kayıtları seçer. Doğrulama durumu PASSED veya WARNING
olmalıdır; ayrıca metin yayımlama ya da keşfedilebilir kaynak/PDF yedeği
koşulları uygulanır. Bu nedenle her satır tam metin yayımlanabilirliği veya
resmî tarih doğrulaması anlamına gelmez. Metin yayımlanamıyorsa güvenli özet
yedeği kullanılabilir. content, contentHtml, sourceMetadata,
storedPdfKey, iç kalite alanları ve kuruma özel notlar yanıta eklenmez.