Skip to content
Developers

Changes · In the sandbox

Company changes

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

Every change with its source gazette: officer appointments/departures, capital, ownership, name/address, articles and status changes in one chronological feed (newest first). Also returns son_gazete.

Authentication

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

Authentication →

Path parameters

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

Query parameters

  • turstringoptional
    Change type filter. Values: yetkili-atama, yetkili-ayrilma, sermaye, ortaklik, unvan-adres, esas-sozlesme, durum
  • kategorilerstringoptional
    Comma-separated change category filter: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi. Unknown category → 400 gecersiz_kategori.
  • sayfaintegeroptional
    Page number (from 1). default: 1
  • adetintegeroptional
    Records per page (default 100, max 500). default: 100

Response fields

200 Changes. 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.
  • son_gazeteSonGazeterequirednullable
    • ilan_idintegerrequired
    • tarihstring (date)required
    • turstringrequired
    • gazete_pdfstring (uri)requirednullable
    • gazete_arsivdebooleanrequired
  • adetintegerrequired
  • sayfaintegerrequired
  • sayfa_adediintegerrequired
  • sonraki_sayfaintegerrequirednullable
  • turlerstring[]required
    Types seen for this company.
  • kategorilerstring[]required
    Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
  • profil_hazirbooleanrequired
  • degisikliklerDegisiklik[]required
    • turstringrequired
      Change type. Values: yetkili-atama, yetkili-ayrilma, sermaye, ortaklik, unvan-adres, esas-sozlesme, durum
    • tarihstring (date)requirednullable
      Date of the change.
    • ozetstringrequired
      One-line summary.
    • 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
      PDF of the source gazette.
    • kategoristringrequired
      Fixed change category. Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
    • isimstringoptionalnullable
    • sifatstringoptionalnullable
    • oncekistringoptionalnullable
    • yenistringoptionalnullable
    • pay_tutaristringoptionalnullable
    • pay_oranistringoptionalnullable
    • alanstringoptionalnullable
    • degerstringoptionalnullable
    • maddestringoptionalnullable
    • baslikstringoptionalnullable
    • aciklamastringoptionalnullable

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