Skip to content
Developers

Companies · In the sandbox

List followed companies

GET/api/v1/sirketler/

Companies you follow: id, name, registry office, registry number, notice count and profile link. Sorted by name and paginated.

Authentication

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

Authentication →

Query parameters

  • sayfaintegeroptional
    Page number (from 1). default: 1
  • adetintegeroptional
    Records per page (default 200, max 1000). default: 200

Response fields

200 Company list. application/json

  • adetintegerrequired
    Total records.
  • sayfaintegerrequired
  • sayfa_adediintegerrequired
    Records per page.
  • sonraki_sayfaintegerrequirednullable
    Next page; null on the last page.
  • sirketlerSirketSatiri[]required
    • idinteger | stringrequired
      Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key.
    • unvanstringrequirednullable
    • mudurlukstringrequirednullable
    • sicil_nostringrequirednullable
    • ilan_sayisiintegerrequired
    • profilstring (uri)required

Error responses

  • 400Invalid parameter (gecersiz_parametre, gecersiz_kategori, gecersiz_tarih…) or the endpoint does not support sandbox keys (deneme_desteklenmiyor).
  • 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