Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

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.

ParametreTip ve sınırDavranış
pageTam sayı, en az 1Varsayılan 1
limitTam sayı, en az 1Varsayılan 10; 20 üzeri değerler doğrulamadan önce 20 ile sınırlanır
sourceTypeSourceType enumBüyük harfli kaynak türü; örn. GIB
sourceSourceType enumsourceType karşılığı; ikisi verilirse source kullanılır
sourceCodeMetin, en fazla 64 karakterKaynak koduyla ek eşitlik filtresi
sourceCategoryMetin, en fazla 64 karakterKaynak ana kategorisi; örn. OZELGE
sourceCategoriesVirgülle ayrılmış metin veya tekrarlanan parametreEn fazla 32 farklı kategori; her biri en fazla 64 karakter
sourceSubcategoryMetin, en fazla 64 karakterAlt kategoriyle eşitlik filtresi
legalDocumentClassMetin, en fazla 64 karakterBelge 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
itemsEn fazla limit güvenli kayıt
page, limitUygulanan sayfa ve sayfa boyutu
hasMoreBir sonraki sayfa için ek kayıt bulunduğunu gösterir
totalIsEstimatedhasMore ile aynı değerdir
total(page - 1) × limit + items.length; hasMore=true ise buna 1 eklenir
totalPagestotal=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

AlanTip ve açıklama
id, title, summaryMetin; başlık ve özet gösterime hazırlanır; özet en fazla 200 karakterlik kesim ve gerekirse … içerir
sourceTypeKaynak türü enum değeri
sourceCode, externalSourceId, externalRevisionMetin veya null; kaynak kodu, dış kimlik ve revizyon
sourceCategory, sourceSubcategory, legalDocumentClassMetin veya null; sınıflandırma kodları
sourceCategoryLabel, sourceSubcategoryLabel, legalDocumentClassLabelMetin veya null; gösterim etiketleri
sourceUrlNormalize edilmiş metin; kullanılabilir kaynak yüzeyi yoksa boş olabilir
originalPdfUrlMetin veya null; uygun PDF bağlantısı, gerektiğinde kaynak URL’sinden çözülür
officialNumberKaynak üst verisindeki belge numarası; yoksa null
officialDateKaynak tarih metni; yoksa yayın tarihinin İstanbul saat diliminde gg.aa.yyyy karşılığı; ISO-8601 olacağı varsayılmaz
publishedAtISO-8601 zaman damgası
impactLevelKRITIK, YUKSEK, ORTA veya BILGILENDIRME
sectorsSektö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.