Skip to content
Developers

Verification and signatures · In the sandbox

Signing authority check

POST/api/v1/sirketler/{sirket_id}/imza-kontrol/

"May this person represent the company on this date, for this transaction and amount?" The result is derived from representation decisions in the notices, terms of office and, if published, the internal directive: yetkili, yetkili_degil or belirsiz. Every reason carries its source notice. Under joint representation pass co-signers in birlikte. Not legal advice; confirm against the current signature circular. The same input may also be sent as a GET query.

Authentication

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

Authentication →

Path parameters

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

Request body application/json

  • kisistringrequired
    Officer full name (required; case and accents ignored).
  • tarihstring (date)optional
    Signing date YYYY-MM-DD (default today).
  • tutarnumber | stringoptional
    Transaction amount (1500000 or "1.500.000,00"); compared with the directive limit.
  • para_birimistringoptional
    Default TRY. default: "TRY"
  • islemstringoptional
    Transaction type (e.g. loan, sale); empty = general representation.
  • birliktestring[]optional
    Names of co-signers (joint representation; max 10).

Response fields

200 Check result. 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.
  • kisistringrequired
  • tarihstring (date)required
  • islemstringrequirednullable
  • tutarnumberrequirednullable
  • para_birimistringrequirednullable
  • sonucstringrequired
    yetkili (authorised) · yetkili_degil (not authorised) · belirsiz (undetermined; see reasons). Values: yetkili, yetkili_degil, belirsiz
  • sonuc_adstringrequired
  • sonuc_enstringrequired
  • bicimstringrequirednullable
    Form of authority. Values: tek_basina, birlikte
  • bicim_adstringrequirednullable
  • bicim_enstringrequirednullable
  • gerekcelerobject[]required
    • kodstringrequired
    • etkistringrequired
      Values: olumlu, olumsuz, belirsiz, bilgi
    • metinstringrequired
    • metin_enstringrequired
    • kaynakImzaKaynakrequirednullable
      • ilan_idintegerrequired
      • ilan_tarihistringrequirednullable
      • sayistringrequired
      • sayfastringrequired
      • ilan_turustringrequired
      • alintistringrequired
      • alinti_dogrulandibooleanrequired
      • gazete_pdfstring (uri)requirednullable
  • kurallarobject[]required
    Representation rules applied (notice or internal directive).
    • kapsamstringrequired
    • bicimstringrequirednullable
    • tutar_siniristringrequirednullable
    • kimstringrequired
    • maddestringrequired
    • birlikte_imzastring[]required
    • alintistringrequired
    • ilanImzaKaynakrequirednullable
      • ilan_idintegerrequired
      • ilan_tarihistringrequirednullable
      • sayistringrequired
      • sayfastringrequired
      • ilan_turustringrequired
      • alintistringrequired
      • alinti_dogrulandibooleanrequired
      • gazete_pdfstring (uri)requirednullable
    • kaynak_turustringrequired
      Values: ilan, ic_yonerge
  • birlikte_imzastring[]required
    Who may co-sign under joint representation.
  • gorev_kayitlariobject[]required
    • isimstringrequirednullable
    • sifatstringrequirednullable
    • temsilstringrequirednullable
    • baslangicstringrequirednullable
    • bitisstringrequirednullable
    • bitis_nedenistringrequirednullable
    • gorev_bitisstringrequirednullable
    • gorev_dayanakstringrequirednullable
    • kaynakImzaKaynakrequirednullable
      • ilan_idintegerrequired
      • ilan_tarihistringrequirednullable
      • sayistringrequired
      • sayfastringrequired
      • ilan_turustringrequired
      • alintistringrequired
      • alinti_dogrulandibooleanrequired
      • gazete_pdfstring (uri)requirednullable
    • bitis_kaynakImzaKaynakrequirednullable
      • ilan_idintegerrequired
      • ilan_tarihistringrequirednullable
      • sayistringrequired
      • sayfastringrequired
      • ilan_turustringrequired
      • alintistringrequired
      • alinti_dogrulandibooleanrequired
      • gazete_pdfstring (uri)requirednullable
    • temsil_kaynakImzaKaynakrequirednullable
      • ilan_idintegerrequired
      • ilan_tarihistringrequirednullable
      • sayistringrequired
      • sayfastringrequired
      • ilan_turustringrequired
      • alintistringrequired
      • alinti_dogrulandibooleanrequired
      • gazete_pdfstring (uri)requirednullable
  • profil_hazirbooleanrequired
  • sinirlarstring[]required
  • sinirlar_enstring[]required
  • uyaristringrequired
    Based on notices; confirm against the current signature circular.
  • uyari_enstringrequired

Error responses

  • 400eksik_parametre (no kisi), gecersiz_tarih, gecersiz_tutar, gecersiz_govde, gecersiz_parametre.
  • 404Not found or no access (bulunamadi).
  • 405GET or POST expected (yontem).
  • 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