Skip to content
Developers

Companies · In the sandbox

Quick lookup (prefill)

GET/api/v1/ara/

Instant candidates from the Ulawk index: name, registry office, registry number, legal form, status, province, address, incorporation and latest notice date. Only companies Ulawk already processes are returned; no live registry lookup is made, nothing is followed and no allowance is used. No personal names and nothing about other customers is returned. Searches by name, registry number or foreign id; Turkish letters, case and legal-form suffixes (A.Ş., Ltd. Şti., GmbH …) are ignored. Without a match you get bulunamadi: true; follow the company with sirket-ekle. This endpoint has its own hourly query limit; bulk harvesting of the index is not permitted.

Authentication

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

Authentication →

Query parameters

  • qstringrequired
    Name, registry number or id (at least 3 letters/digits).
  • ulkestringoptional
    Country filter (TR, GB …); all if omitted.
  • adetintegeroptional
    Max candidates (default 10, max 20). default: 10
  • mudurlukstringoptional
    Only this registry office (Turkey).
  • faalstringoptional
    1 → only companies whose status is FAAL. Values: 1

Response fields

200 Candidates (may be empty). application/json

  • sorgustringrequired
  • ulkestringrequirednullable
    Country filter or null (all).
  • adetintegerrequired
  • kaynakstringrequired
    Values: ulawk_dizini
  • bulunamadibooleanrequired
    No candidate in the index: follow the company to build a sourced profile.
  • aciklamastringrequired
  • takibe_alstring (uri)required
    Follow endpoint (POST).
  • adaylarHizliSorguAdayi[]required
    • ulkestringrequired
      ISO country code (TR; abroad the record's country, ZZ = LEI).
    • kimlikstringrequired
      Index id: in Turkey OFFICE/registry root (e.g. İSTANBUL/325075), abroad the registry id.
    • mudurlukstringrequirednullable
      Trade registry office (Turkey only); pass it to sirket-ekle as is.
    • sicil_nostringrequirednullable
      Registry number (Turkey only).
    • unvanstringrequired
      Name (in Turkey as written in the latest gazette notice).
    • hukuki_bicimobjectrequired
      • kodstringrequired
        Ulawk form code (TR_AS, TR_LTD, YB_GMBH …; BILINMIYOR if unknown).
      • yerelstringrequirednullable
        Local name.
      • enstringrequirednullable
        English name.
      • isostringrequirednullable
        ISO 20275 (ELF) code; null without an exact match in the list.
      • kategoristringrequired
        Standard category: ANONIM, LIMITED, SAHIS_SIRKETI, KOOPERATIF, SUBE …
    • durumobjectrequired
      • kodstringrequired
        Values: FAAL, IFLAS_KONKORDATO, TASFIYEDE, KAPANDI, BILINMIYOR
      • adstringrequired
      • yerelstringrequired
        Wording in the source or notice.
      • uluslararasistringrequired
        International equivalent (ACTIVE, PENDING_DISSOLUTION, CLOSED …).
    • ilstringrequirednullable
      Province (from the registry office; Turkey only).
    • adresstringrequirednullable
      Registered address (from the identity section of the sourced profile; null if none).
    • kurulusstring (date)requirednullable
      Incorporation date (YYYY-MM-DD) or null.
    • son_ilan_tarihistring (date)requirednullable
      Latest notice/event date in the index.
    • kaynakstringrequired
      Values: ulawk_dizini
    • guncellik_tarihistring (date)requirednullable
      The day Ulawk last observed the data; it does not mean the answer is current.
    • eslesmestringrequired
      tam: registry no / id exact or same bare name · yakin: name starts with the query or is very similar · kismi: all words appear. Values: tam, yakin, kismi
    • skornumberrequired
      0–1 similarity.
    • takiptebooleanrequired
      Whether the company is on YOUR list (other customers' lists are never disclosed).
    • sirket_idinteger | stringrequirednullable
      Your company id when followed (/api/v1/sirketler/{id}/).
    • profilstring (uri)requirednullable
      Sourced profile address when followed.

Error responses

  • 400gecersiz_parametre (q too short, invalid ulke or adet).
  • 405GET expected (yontem).
  • 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