Companies · In the sandbox

Company profile

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

Full sourced profile: summary, identity, officers, capital, ownership, name/address, articles, one chronological change feed, notices and report findings. Every record carries kaynak. veri_durumu states how complete each section is; empty list [] = looked, none · null = not available or still being prepared.

Authentication

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

Authentication →

Path parameters

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

Response fields

200 Profile. 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.
tum_gazeteler_zipstring (uri)required
All gazette PDFs (ZIP).
profil_hazirbooleanrequired
Whether the profile exists. While false, profile sections are null.
guncellemestring (date-time)requirednullable
When the profile was generated.
ozetstringrequirednullable
Neutral AI-written summary.
kimlikKimlikrequirednullable
- unvanstringoptionalnullable
- turstringoptionalnullable
  Company type (e.g. Anonim Şirket).
- merkezstringoptionalnullable
  Registered office.
- kurulus_tarihistringoptionalnullable
  Incorporation date (YYYY-MM-DD; "… or earlier" when no incorporation notice).
- sermayestringoptionalnullable
- durumstringoptionalnullable
  Status from notices.
- durum_aciklamastringoptionalnullable
- kurulus_suphelibooleanoptional
  No incorporation notice; date from the oldest notice.
- kurulus_kaynakobjectoptionalnullable
- hukuki_bicim_standartHukukiBicimoptionalnullable
  kodstringrequired
  Standard form code (e.g. TR_AS).
  yerel_adstringoptional
  kisaltmastringoptional
  en_adstringoptional
  standart_kategorianyoptional
  General class of the form.
  iso20275stringoptionalnullable
  ISO 20275 (ELF) code when verified.
  iso20275_listestringoptionalnullable
  ulkestringoptionalnullable
  ana_bicimobjectoptionalnullable
  girdistringoptional
- 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.
yetkililerYetkili[]requirednullable
- isimstringrequirednullable
- sifatstringrequirednullable
  Title in the notice.
- temsilstringrequirednullable
  Representation (sole, joint…).
- baslangicstring (date)requirednullable
  Start of office.
- bitisstring (date)requirednullable
  End of office; null while in office.
- bitis_nedenistringrequirednullable
- gorev_bitisstringrequirednullable
  Expected end of term.
- gorev_suresistringrequirednullable
- gorev_dayanakstringrequirednullable
  Basis of the term end (notice or statute).
- 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.
- bitis_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.
- gorevdebooleanrequired
  Whether in office today.
- rol_standartRoloptionalnullable
  kodstringrequired
  adstringoptional
  en_adstringoptional
  organstringoptionalnullable
  temsil_organibooleanoptionalnullable
  kesinbooleanoptional
  rollerstring[]optional
  imza_derecesistringoptionalnullable
  iso5009stringoptionalnullable
  iso5009_listestringoptionalnullable
  yerel_adstringoptional
sermayeSermayeKaydi[]requirednullable
- tarihstring (date)requirednullable
- islemstringrequirednullable
- oncekistringrequirednullable
- yenistringrequirednullable
- 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.
ortaklikOrtaklikKaydi[]requirednullable
- tarihstring (date)requirednullable
- isimstringrequirednullable
- pay_tutaristringrequirednullable
- pay_oranistringrequirednullable
- 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.
unvan_adresUnvanAdresKaydi[]requirednullable
- tarihstring (date)requirednullable
- turstringrequirednullable
  unvan (name) or adres (address)
- degerstringrequirednullable
- 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.
esas_sozlesmeEsasSozlesmeMaddesi[]requirednullable
- maddestringrequirednullable
- baslikstringrequirednullable
- hukumstringrequirednullable
  AI summary of the current wording; see the source for the verbatim text.
- son_degisiklikstring (date)requirednullable
- 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.
degisikliklerDegisiklik[]requirednullable
All changes in one chronological feed (newest first).
- 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
son_gazeteSonGazeterequirednullable
- ilan_idintegerrequired
- tarihstring (date)required
- turstringrequired
- gazete_pdfstring (uri)requirednullable
- gazete_arsivdebooleanrequired
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
raporlarRaporOzeti[]required
- rapor_idintegerrequired
- durumstringrequired
  Values: hazir, hata, hazirlaniyor
- talepstring (date-time)requirednullable
- tamamlanmastring (date-time)requirednullable
- dosyalarobjectrequired
  Type → download URL.
  {…} → string (uri)
- bulgularobjectrequirednullable
  Report findings (single profile only).
aciklama_degisikliklerstringrequired
aciklamastringrequired
aciklama_veri_durumustringrequired
veri_durumuVeriDurumurequired
Completeness, method and limits per section. New sections are additive.
- kimlikVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- yetkililerVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- sermayeVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- ortaklikVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- unvan_adresVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- esas_sozlesmeVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- ozetVeriDurumuBolumoptional
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- ilanlarVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- raporlarVeriDurumuBolumoptional
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- gercek_faydalanicilarVeriDurumuBolumrequired
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- durumVeriDurumuBolumoptional
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- uyum_sinyalleriVeriDurumuBolumoptional
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
- hukuki_bicimVeriDurumuBolumoptional
  durumstringrequired
  tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it). Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI) Values: ilandan, ilandan_kuruldu, turetilmis, yapay_zeka
  sinirlarstring[]required
  Human-readable limitations.
  dayanak_ilan_sayisiintegerrequirednullable
  Number of distinct notices used.
gercek_faydalanicilarstringrequired
Beneficial ownership is not published in a public register in Türkiye; the profile calculates it from the shareholdings in the notices. Values: yayimlanmiyor
durumStandartDurumoptional
Status standardised from notice wording by fixed rules.
- kodstringrequired
- adstringoptional
- ad_enstringoptional
- uluslararasistringoptionalnullable
- renkstringoptionalnullable
- tuzel_kisilik_suruyorbooleanoptionalnullable
- yerel_durumstringoptionalnullable
- kapanis_nedeniobjectoptionalnullable
- baslangicstringoptionalnullable
- kapanis_tarihistringoptionalnullable
- kaynakobjectoptionalnullable
- dayanakstringoptionalnullable
- aciklamastringoptionalnullable
- aciklama_enstringoptionalnullable
- gecmisobject[]optional
uyum_sinyalleriUyumSinyali[]optional
- turstringrequired
- adstringoptional
- ad_enstringoptional
- aktifbooleanrequirednullable
- aciklamastringoptional
- aciklama_enstringoptional
- kaynakobjectoptionalnullable
- tarihstringoptionalnullable
- tarih_trstringoptionalnullable
- dayanakstringoptionalnullable

Error responses

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

Company profile

#Authentication

#Path parameters

#Response fields

#Error responses

Authentication

Path parameters

Response fields

Error responses