Skip to content
Developers

Companies · In the sandbox

Officers on a date

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

Officers in office on the given date (title, representation, term, source). Without tarih, the current officers. Use it to check whether a signatory was authorised on that date.

Authentication

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

Authentication →

Path parameters

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

Query parameters

  • tarihstring (date)optional
    YYYY-MM-DD.

Response fields

200 Officers. 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.
  • tarihstringrequired
    Requested date or "güncel" (current).
  • adetintegerrequired
  • profil_hazirbooleanrequired
  • yetkililerYetkili[]required
    • 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

Error responses

  • 400gecersiz_tarih.
  • 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