Skip to content
Developers

Companies · In the sandbox

Term expiries

GET/api/v1/gorev-bitisleri/

Officers across all your companies whose term ends within gun days or has lapsed without renewal (by days left). For reminders and calendar integrations.

Authentication

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

Authentication →

Query parameters

  • gunintegeroptional
    Horizon (days). default: 120

Response fields

200 Term expiries. application/json

  • ufuk_gunintegerrequired
  • adetintegerrequired
  • gorevlerGorevBitisi[]required
    • grup_idinteger | stringrequired
      Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key.
    • unvanstringrequirednullable
    • isimstringrequirednullable
    • sifatstringrequired
    • temsilstringrequired
    • gorev_bitisstring (date)requirednullable
    • kalanintegerrequired
      Days left; negative when expired.
    • gorev_suresistringrequired
    • dayanakstringrequired
    • durumstringrequired
      Values: yaklasiyor, doldu

Error responses

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