Skip to content
Developers

Companies · In the sandbox

Preparation status

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

Preparation stage of a newly added company: notices → gazette archive → profile. Poll every few minutes until hazir. Branch records report sube directly.

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 Preparation status. 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.
  • asamastringrequired
    ilanlar-cekiliyor → gazeteler-indiriliyor → profil-hazirlaniyor → hazir; sube for branches. Values: ilanlar-cekiliyor, gazeteler-indiriliyor, profil-hazirlaniyor, hazir, sube
  • asama_adistringrequired
  • yuzdeintegerrequired
  • ilan_sayisiintegerrequired
  • arsivdeki_gazeteintegerrequired
  • profil_hazirbooleanrequired
  • guncellemestring (date-time)requirednullable
  • profilstring (uri)required

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

Markdown · OpenAPI · llms.txt · © 2026 Ulawk