Skip to content
Developers

Notices and gazettes · In the sandbox

Company notices

GET/api/v1/sirketler/{sirket_id}/ilanlar/

The company's Trade Registry Gazette notices (newest first): date, type, issue/page, plain-language title and description, gazette PDF link and change category.

Authentication

  • X-API-Keyheaderrequired
    ulk_…
  • X-API-Secretheaderrequired
    ulsk_…

Authentication →

Path parameters

  • sirket_idinteger | stringrequired
    Company id (id from /api/v1/sirketler/).

Query parameters

  • kategoristringoptional
    Comma-separated notice-type category (legacy filter): kurulus, konkordato, birlesme, sermaye, ortaklik, yonetim, unvan_adres, genel_kurul, esas, diger.
  • kategorilerstringoptional
    Comma-separated change category filter: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi. Unknown category → 400 gecersiz_kategori.

Response fields

200 Notices. application/json

  • sirketSirketOzetrequired
    • idinteger | stringrequired
      Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key.
    • unvanstringrequirednullable
      Registered name.
    • mudurlukstringrequirednullable
      Registry office (e.g. İSTANBUL).
    • sicil_nostringrequirednullable
      Trade registry number.
  • adetintegerrequired
  • ilanlarIlan[]required
    • ilan_idintegerrequired
    • tarihstring (date)required
    • turstringrequired
      Notice type.
    • kategoristringrequired
      Notice-type category (legacy kategori= filter). Values: kurulus, konkordato, birlesme, sermaye, ortaklik, yonetim, unvan_adres, genel_kurul, esas, diger
    • kategori_adstringrequired
    • sicil_nostringrequirednullable
    • sayistringrequirednullable
      Gazette issue number.
    • sayfastringrequirednullable
      Gazette page.
    • baslikstringrequirednullable
      Plain-language title.
    • aciklamastringrequirednullable
    • kaynakKaynakrequirednullable
      • ilan_idintegerrequired
        The notice the fact comes from.
      • ilan_tarihistring (date)required
        Publication date of the notice.
      • ilan_turustringrequired
        Trade Registry Gazette notice type.
      • alintistringrequired
        Verbatim quote from the notice text.
      • alinti_dogrulandibooleanrequired
        Whether the quote was found verbatim in the notice.
      • gazete_pdfstring (uri)required
        Gazette PDF.
      • vurguVurgurequirednullable
        • sayfaintegerrequired
          Gazette page (from 1).
        • sayfa_gorselstring (uri)required
          PNG image of the page.
        • kutularnumber[][]required
          Where the fact sits on the page: proportional [x0, y0, x1, y1] boxes (0–1, top-left origin).
        • kutu_birimistringrequired
          Description of the box unit.
    • gazete_pdfstring (uri)requirednullable
      Gazette PDF when archived.
    • gazete_arsivdebooleanrequired
    • degisiklik_kategorisistringrequired
      Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi

Error responses

  • 400Invalid parameter (gecersiz_parametre, gecersiz_kategori, gecersiz_tarih…) or the endpoint does not support sandbox keys (deneme_desteklenmiyor).
  • 404Not found or no access (bulunamadi).
  • 503The official source is unreachable right now (kaynak_erisilemiyor, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.
  • 401Missing or invalid key (yetkisiz).
  • 429Hourly rate limit exceeded (hiz_siniri); the Retry-After header gives the seconds until reset.
  • 500Unexpected error (ic_hata, taraf ulawk); retry shortly.

Error responses → hata, detay, hata_ayrinti

Markdown · OpenAPI · llms.txt · © 2026 Ulawk