Companies · In the sandbox

Follow a company

POST/api/v1/sirket-ekle/

Follows a company by registry office and registry number. The request does not wait: the record is created at once and notices and the profile are prepared in the background; poll durum_adresi. If the same company (same office + same registry root, 325075-0 = 325075) is already on your list, no second record is created, zaten_var is returned and no allowance is used. With a sandbox key nothing is created; a new number is routed to the DENEME-YAVAS flow.

Authentication

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

Authentication →

Request body application/json

mudurlukstringrequired
Registry office (e.g. İSTANBUL).
sicil_nostringrequired
Registry number; starts with a digit.
unvanstringoptional
Optional company name.

Response fields

201 Followed (eklendi). application/json

durumstringrequired
eklendi (201) or zaten_var (200, no allowance used). Values: eklendi, zaten_var
sirket_idinteger | stringrequired
Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key.
kayit_idintegerrequirednullable
unvanstringoptionalnullable
mudurlukstringrequired
sicil_nostringrequired
aciklamastringoptional
profilstring (uri)required
durum_adresistring (uri)required
Status polling URL.

200 Already on your list (zaten_var). application/json

Same fields as 201.

Error responses

400eksik_alan or gecersiz_sicil.
402Plan allowance used up (kota_doldu).
405POST 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

curl -X POST "https://ulawk.com/api/v1/sirket-ekle/" \ -H "X-API-Key: ulk_DENEME_ANAHTARINIZ" \ -H "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ" \ -H "Content-Type: application/json" \ -d '{"mudurluk": "İSTANBUL", "sicil_no": "555555"}'

import requests basliklar = {"X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ"} yanit = requests.post("https://ulawk.com/api/v1/sirket-ekle/", headers=basliklar, json={"mudurluk": "İSTANBUL", "sicil_no": "555555"}, timeout=30) veri = yanit.json() if not yanit.ok: # hata_ayrinti.tekrar_denenebilir ise Retry-After kadar bekleyip yeniden deneyin print(yanit.status_code, veri["hata_ayrinti"]) print(veri)

const yanit = await fetch("https://ulawk.com/api/v1/sirket-ekle/", { method: "POST", headers: { "X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ", "Content-Type": "application/json" }, body: JSON.stringify({"mudurluk": "İSTANBUL", "sicil_no": "555555"}) }); const veri = await yanit.json(); if (!yanit.ok) console.error(yanit.status, veri.hata_ayrinti); console.log(veri);

<?php $ch = curl_init("https://ulawk.com/api/v1/sirket-ekle/"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_HTTPHEADER => ["X-API-Key: ulk_DENEME_ANAHTARINIZ", "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ", "Content-Type: application/json"], CURLOPT_POSTFIELDS => '{"mudurluk": "İSTANBUL", "sicil_no": "555555"}', ]); $govde = curl_exec($ch); $kod = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $veri = json_decode($govde, true); var_dump($kod, $veri);

using var http = new HttpClient(); http.DefaultRequestHeaders.Add("X-API-Key", "ulk_DENEME_ANAHTARINIZ"); http.DefaultRequestHeaders.Add("X-API-Secret", "ulsk_DENEME_GIZLI_ANAHTARINIZ"); var istek = new HttpRequestMessage(new HttpMethod("POST"), "https://ulawk.com/api/v1/sirket-ekle/"); istek.Content = new StringContent("{\"mudurluk\": \"İSTANBUL\", \"sicil_no\": \"555555\"}", System.Text.Encoding.UTF8, "application/json"); var yanit = await http.SendAsync(istek); var metin = await yanit.Content.ReadAsStringAsync(); Console.WriteLine($"{(int)yanit.StatusCode} {metin}");

{ "durum": "eklendi", "sirket_id": "DENEME-YAVAS", "kayit_id": null, "mudurluk": "İSTANBUL", "sicil_no": "555555", "aciklama": "Deneme ortamı: kayıt açılmadı, paket hakkı harcanmadı. Hazırlanma akışını DENEME-YAVAS ile izleyin.", "profil": "https://ulawk.com/api/v1/sirketler/DENEME-YAVAS/", "durum_adresi": "https://ulawk.com/api/v1/sirketler/DENEME-YAVAS/durum/" }

{ "durum": "zaten_var", "sirket_id": "DENEME-100001", "kayit_id": null, "unvan": "ÖRNEK DENEME SANAYİ VE TİCARET ANONİM ŞİRKETİ", "mudurluk": "İSTANBUL", "sicil_no": "DENEME-100001", "profil": "https://ulawk.com/api/v1/sirketler/DENEME-100001/", "durum_adresi": "https://ulawk.com/api/v1/sirketler/DENEME-100001/durum/" }

{ "hata": "eksik_alan", "detay": "'mudurluk' ve 'sicil_no' zorunludur.", "hata_ayrinti": { "kod": "eksik_alan", "mesaj": "'mudurluk' ve 'sicil_no' zorunludur.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

{ "hata": "kota_doldu", "detay": "Paket şirket hakkınız doldu.", "hata_ayrinti": { "kod": "kota_doldu", "mesaj": "Paket şirket hakkınız doldu.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

{ "hata": "yontem", "detay": "POST bekleniyor.", "hata_ayrinti": { "kod": "yontem", "mesaj": "POST bekleniyor.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

{ "hata": "yetkisiz", "detay": "Geçerli X-API-Key başlığı gerekli (panel › API).", "hata_ayrinti": { "kod": "yetkisiz", "mesaj": "Geçerli X-API-Key başlığı gerekli (panel › API).", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

Retry-After: 66 { "hata": "hiz_siniri", "detay": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.", "hata_ayrinti": { "kod": "hiz_siniri", "mesaj": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 66 } }

Retry-After: 60 { "hata": "ic_hata", "detay": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.", "hata_ayrinti": { "kod": "ic_hata", "mesaj": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.", "taraf": "ulawk", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 60 } }

Follow a company

#Authentication

#Request body application/json

#Response fields

#Error responses

Authentication

Request body application/json

Response fields

Error responses