Verification and signatures · In the sandbox

Verification report

GET/api/v1/sirketler/{sirket_id}/dogrulama-raporu.pdf

A sealed verification report (PDF) built from the company's sourced profile. Every fact carries its source notice reference (date · issue · page) and a verbatim quote; the cover shows the seal: DOGRULANDI, KISMI or DOGRULANMADI. The report id is derived from the content: the same content gives the same id and can be re-downloaded free with ?rapor=DR-…. ?bicim=json returns the same content as JSON, ?bicim=html as a printable page. ?tam_zorunlu=1: 409 veri_eksik unless the seal is DOGRULANDI. Response headers: X-Ulawk-Rapor-Kimligi, X-Ulawk-Muhur, X-Ulawk-Icerik-Ozeti, X-Ulawk-Veri-Durumu.

Authentication

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

Authentication →

Path parameters

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

Query parameters

dilstringoptional
en → English report (default Turkish). Values: en
raporstringoptional
Id of an earlier report: the same snapshot is redrawn.
bicimstringoptional
Output format. Values: pdf, json, html default: pdf
tam_zorunlustringoptional
1 → only a DOGRULANDI report, otherwise 409. Values: 1
indirstringoptional
1 → download the PDF as a file. Values: 1

Response fields

200 Report (PDF; ?bicim=json → JSON; ?bicim=html → HTML). application/json

rapor_kimligistringrequired
DR-XXXX-XXXX-XXXX: from the content digest; same content → same id.
muhurstringrequired
Values: DOGRULANDI, KISMI, DOGRULANMADI
muhur_adstringrequired
icerik_ozetistringrequired
SHA-256 digest of the content.
uretim_tarihistring (date)required
bekleyen_bolumlerstring[]required
veriDogrulamaVerisirequired
Language-independent snapshot of the report; dates DD.MM.YYYY.
- surumintegerrequired
- denemebooleanrequired
- 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.
- profil_hazirbooleanrequired
- muhurMuhurrequired
  The seal states how well facts are tied to sources, not whether the content is true.
  kodstringrequired
  DOGRULANDI: core sections complete and every fact tied to a verified quote · KISMI: profile ready but a condition is not met (see reasons) · DOGRULANMADI: profile not ready. Values: DOGRULANDI, KISMI, DOGRULANMADI
  gerekcelerobject[]required
  trstringrequired
  enstringrequired
- veri_tamligiobject[]required
  bolumstringrequired
  durumstringrequired
  Values: tam, kismi, yok, hazirlaniyor, yayimlanmiyor
  yontemstringrequirednullable
  dayanakintegerrequirednullable
  sinirlarstring[]required
  yapisalbooleanrequired
  Whether partial status is only a structural limit (joint-stock ownership).
- alintilarobjectrequired
  toplamintegerrequired
  dogrulananintegerrequired
  dogrulanmayanintegerrequired
  kaynaksizintegerrequired
- kimlikobjectrequirednullable
  unvanstringrequirednullable
  turstringrequired
  merkezstringrequired
  kurulus_tarihistringrequired
  sermayestringrequired
  hukuki_bicimstringrequired
  hukuki_bicim_enstringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
- durumobjectrequirednullable
  kodstringrequirednullable
  adstringrequirednullable
  ad_enstringrequirednullable
  uluslararasistringrequirednullable
  yerelstringrequired
  aciklamastringrequired
  aciklama_enstringrequired
  dayanakstringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
- yetkililerRaporYetkilisi[]requirednullable
  Officers in office (latest appointment per person).
  isimstringrequirednullable
  sifatstringrequired
  temsilstringrequired
  baslangicstringrequired
  gorev_bitisstringrequired
  gorev_dayanakstringrequired
  suresi_dolmusbooleanrequired
  yeni_kurulstringrequired
  derecestringrequirednullable
  Signing tier (1, 2…).
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
  temsil_kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
  birliktestring[]optional
  Who they may sign with under joint representation (officers in office only).
- bitmis_gorunen_yetkililerRaporYetkilisi[]requirednullable
  Term lapsed and not named in the next election.
  isimstringrequirednullable
  sifatstringrequired
  temsilstringrequired
  baslangicstringrequired
  gorev_bitisstringrequired
  gorev_dayanakstringrequired
  suresi_dolmusbooleanrequired
  yeni_kurulstringrequired
  derecestringrequirednullable
  Signing tier (1, 2…).
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
  temsil_kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
  birliktestring[]optional
  Who they may sign with under joint representation (officers in office only).
- sermayeobjectrequirednullable
  guncelstringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
  gecmisobject[]required
  tarihstringrequired
  islemstringrequired
  oncekistringrequired
  yenistringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
- ortaklarobjectrequirednullable
  anonimbooleanrequired
  tarihstringrequirednullable
  listeobject[]required
  isimstringrequirednullable
  pay_tutaristringrequired
  pay_oranistringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
- uyumobject[]requirednullable
  turstringrequired
  adstringrequirednullable
  ad_enstringrequirednullable
  aktifbooleanrequirednullable
  aciklamastringrequired
  aciklama_enstringrequired
  dayanakstringrequired
  tarihstringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
- yaptirimobjectrequired
  Exact-name hits only; no screening in the sandbox.
  tarandibooleanrequired
  denemebooleanrequired
  tarananintegerrequired
  isabetlerobject[]required
  adstringrequired
  rolstringrequired
  listestringrequirednullable
  liste_kaydistringrequired
  programstringrequired
  liste_tarihistringrequired
- degisikliklerobject[]required
  Last 10 changes.
  tarihstringrequired
  turstringrequired
  kategoristringrequired
  ozetstringrequired
  ozet_enstringrequired
  kaynakobjectrequirednullable
  ilan_idintegerrequired
  tarihstringrequired
  Notice date (DD.MM.YYYY).
  sayistringrequired
  Gazette issue.
  sayfastringrequired
  Gazette page.
  alintistringrequired
  Short verbatim quote from the notice.
  dogrulandibooleanrequired
- ilan_sayisiintegerrequired
pdfstring (uri)required
PDF of the same report (free re-download with ?rapor=…).

Error responses

404Company or ?rapor= id not found (bulunamadi).
409?tam_zorunlu=1 and the seal is not DOGRULANDI (veri_eksik; muhur, bekleyen_bolumler, rapor_kimligi).
503PDF could not be produced right now (pdf_uretilemedi; try ?bicim=html) or the source is unreachable.
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

Verification report

#Authentication

#Path parameters

#Query parameters

#Response fields

#Error responses

Authentication

Path parameters

Query parameters

Response fields

Error responses