İçeriğe geç

KAP bildirimleri

GET /v1/news: bildirim listesi (cursor sayfalama); GET /v1/news/{id}: içerik blokları ve ekler.

Yetki: news:read

Kamuyu Aydınlatma Platformu (KAP) bildirimleri. Kimlik KAP'ın kendi bildirim numarasıdır (disclosureIndex); aynı numara KAP sayfasında da görünür. Anlık akış (SSE) ve giden webhook ayrı bir modül olarak planlıdır; bu sürümde yalnız okuma vardır.

GET /v1/news

En yeniden eskiye sıralı liste. Gövde listede yoktur, detay ucundan alınır.

Parametreler

ParametreTipZorunluAçıklama
symbolsstringhayırVirgülle ayrılmış semboller, en fazla 50: THYAO,ASELS
typesstringhayırBildirim sınıfı, virgülle: FR (finansal rapor), ODA (özel durum), CA, DG, DUY, FON
qstringhayırBaşlıkta arama; her kelime geçmeli, Türkçe karakter toleranslı (kar → Kâr)
fromstringhayırYYYY-MM-DD (İstanbul günü başı) ya da ISO zaman damgası
tostringhayırYYYY-MM-DD (İstanbul günü sonu) ya da ISO zaman damgası
cursornumberhayırÖnceki yanıttaki meta.nextCursor; ondan küçük numaralı bildirimler döner
limitnumberhayır1 ile 100 arası, varsayılan 20

Örnek

curl "https://api.istfin.com/v1/news?symbols=THYAO&types=ODA,FR&limit=20" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": [
    {
      "id": 1412345,
      "type": "ODA",
      "symbols": ["THYAO"],
      "title": "Yeni Uçak Siparişi Hakkında",
      "summary": "Şirket 30 adet dar gövdeli uçak siparişi verdi.",
      "isUpdate": false,
      "isCorrection": false,
      "publishedAt": "2026-10-06T07:32:11.000Z",
      "url": "https://www.kap.org.tr/tr/Bildirim/1412345"
    }
  ],
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j", "nextCursor": "1412345", "hasMore": true }
}

Sonraki sayfa için cursor=1412345 gönderin; hasMore false olana kadar devam edin.

GET /v1/news/{id}

Tek bildirimin tam içeriği. Bulunamazsa 404 NOT_FOUND.

Örnek

curl "https://api.istfin.com/v1/news/1412345" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

Liste alanlarına ek olarak:

AlanTipAçıklama
fundsstring[]İlgili fon kodları
sectorsstring[]İlgili sektörler
content{ type, label, value }[]İçerik blokları: field (etiket/değer), section, text, html
attachments{ fileName, url }[]Ekler
updatedAtstring | nullSon güncelleme (UTC)

Bu sayfada