İçeriğe geç
Geliştirici

Şirketler · Deneme ortamında

Hızlı sorgu (ön doldurma)

GET/api/v1/ara/

Ulawk dizinindeki şirketlerden anında aday: unvan, müdürlük, sicil no, hukuki biçim, durum, il, adres, kuruluş ve son ilan tarihi. Yalnız Ulawk'ın zaten işlediği şirketler döner; canlı sicil sorgusu yapılmaz, takip eklenmez, paket hakkı harcanmaz. Kişi adı ve başka müşterilere ait bilgi dönmez. Unvan, sicil numarası ya da yurt dışı kimlikle arar; Türkçe harf, büyük/küçük harf ve hukuki biçim eki (A.Ş., Ltd. Şti., GmbH …) farkı önemsizdir. Bulunamazsa bulunamadi: true; şirketi sirket-ekle ile takibe alın. Bu uca ayrıca saatlik sorgu sınırı uygulanır; dizini toplu çekmek kullanım şartlarına aykırıdır.

Kimlik doğrulama

  • X-API-Keyheaderzorunlu
    ulk_…
  • X-API-Secretheaderzorunlu
    ulsk_…

Kimlik doğrulama →

Sorgu parametreleri

  • qstringzorunlu
    Unvan, sicil no ya da kimlik (en az 3 harf/rakam).
  • ulkestringisteğe bağlı
    Ülke süzgeci (TR, GB …); yoksa tümü.
  • adetintegeristeğe bağlı
    En çok aday (varsayılan 10, en çok 20). varsayılan: 10
  • mudurlukstringisteğe bağlı
    Yalnız bu sicil müdürlüğü (Türkiye).
  • faalstringisteğe bağlı
    1 → yalnız durumu FAAL olanlar. Değerler: 1

Yanıt alanları

200 Adaylar (boş olabilir). application/json

  • sorgustringzorunlu
  • ulkestringzorunlunull olabilir
    Süzülen ülke ya da null (tümü).
  • adetintegerzorunlu
  • kaynakstringzorunlu
    Değerler: ulawk_dizini
  • bulunamadibooleanzorunlu
    Dizinde aday yok: şirketi takibe alarak kaynaklı profil oluşturun.
  • aciklamastringzorunlu
  • takibe_alstring (uri)zorunlu
    Takibe alma ucu (POST).
  • adaylarHizliSorguAdayi[]zorunlu
    • ulkestringzorunlu
      ISO ülke kodu (TR; yurt dışında kaydın ülkesi, ZZ = LEI).
    • kimlikstringzorunlu
      Dizin kimliği: Türkiye'de MÜDÜRLÜK/sicil kökü (ör. İSTANBUL/325075), yurt dışında sicil kimliği.
    • mudurlukstringzorunlunull olabilir
      Ticaret sicil müdürlüğü (yalnız Türkiye); sirket-ekle gövdesine aynen verilir.
    • sicil_nostringzorunlunull olabilir
      Sicil numarası (yalnız Türkiye).
    • unvanstringzorunlu
      Unvan (Türkiye'de en yeni TTSG ilanındaki yazımı).
    • hukuki_bicimobjectzorunlu
      • kodstringzorunlu
        Ulawk biçim kodu (TR_AS, TR_LTD, YB_GMBH …; bilinmiyorsa BILINMIYOR).
      • yerelstringzorunlunull olabilir
        Yerel ad.
      • enstringzorunlunull olabilir
        İngilizce ad.
      • isostringzorunlunull olabilir
        ISO 20275 (ELF) kodu; listede birebir karşılığı yoksa null.
      • kategoristringzorunlu
        Standart kategori: ANONIM, LIMITED, SAHIS_SIRKETI, KOOPERATIF, SUBE …
    • durumobjectzorunlu
      • kodstringzorunlu
        Değerler: FAAL, IFLAS_KONKORDATO, TASFIYEDE, KAPANDI, BILINMIYOR
      • adstringzorunlu
      • yerelstringzorunlu
        Kaynaktaki ya da ilandaki ifade.
      • uluslararasistringzorunlu
        Uluslararası karşılık (ACTIVE, PENDING_DISSOLUTION, CLOSED …).
    • ilstringzorunlunull olabilir
      İl (müdürlükten; yalnız Türkiye).
    • adresstringzorunlunull olabilir
      Merkez adresi (kaynaklı profilin kimlik bölümünden; yoksa null).
    • kurulusstring (date)zorunlunull olabilir
      Kuruluş tarihi (YYYY-AA-GG) ya da null.
    • son_ilan_tarihistring (date)zorunlunull olabilir
      Dizindeki en yeni ilan/olay tarihi.
    • kaynakstringzorunlu
      Değerler: ulawk_dizini
    • guncellik_tarihistring (date)zorunlunull olabilir
      Bilginin Ulawk'ta son gözlendiği gün; yanıtın güncel olduğu anlamına gelmez.
    • eslesmestringzorunlu
      tam: sicil no / kimlik birebir ya da sade unvan aynı · yakin: unvan sorguyla başlıyor ya da çok benzer · kismi: tüm sözcükler geçiyor. Değerler: tam, yakin, kismi
    • skornumberzorunlu
      0–1 benzerlik.
    • takiptebooleanzorunlu
      Şirket SİZİN listenizde mi (başka müşterilerin listesi hiçbir zaman söylenmez).
    • sirket_idinteger | stringzorunlunull olabilir
      Takipteyse şirket kimliğiniz (/api/v1/sirketler/{id}/).
    • profilstring (uri)zorunlunull olabilir
      Takipteyse kaynaklı profil adresi.

Hata yanıtları

  • 400gecersiz_parametre (q kısa, ulke ya da adet geçersiz).
  • 405GET bekleniyor (yontem).
  • 401Anahtar yok ya da geçersiz (yetkisiz).
  • 429Saatlik istek sınırı aşıldı (hiz_siniri); Retry-After başlığı sıfırlanmaya kalan saniyeyi verir.
  • 500Beklenmeyen hata (ic_hata, taraf ulawk); kısa süre sonra yeniden deneyin.

Hata yanıtları → hata, detay, hata_ayrinti

Markdown · OpenAPI · llms.txt · © 2026 Ulawk