# Ulawk Developer documentation

> API for Turkish trade registry monitoring: sourced profiles, changes, notices, gazette PDFs, webhooks, a sandbox and MCP. Every page is available as Markdown by appending .md to its address.

- [OpenAPI 3.1](https://ulawk.com/en/gelistirici/openapi.json)

## Documentation

- [Introduction](https://ulawk.com/en/gelistirici.md): Ulawk API: monitor companies in the Turkish trade registry with sourced data.
- [Authentication](https://ulawk.com/en/gelistirici/kimlik-dogrulama.md): X-API-Key and X-API-Secret headers; sandbox and live keys.
- [Quickstart](https://ulawk.com/en/gelistirici/hizli-baslangic.md): Add a company → poll its status → read the profile → subscribe a webhook.
- [Data status and the empty-list rule](https://ulawk.com/en/gelistirici/veri-durumu.md): veri_durumu : completeness, method and limits per section.
- [Source trail](https://ulawk.com/en/gelistirici/kaynak-izi.md): The notice, verbatim quote and gazette position behind every fact.
- [Verification report and signing check](https://ulawk.com/en/gelistirici/dogrulama-ve-imza.md): A sealed verification report and a "is this signature valid?" check.
- [Quick lookup and form prefill](https://ulawk.com/en/gelistirici/hizli-sorgu.md): Instant company candidates from the Ulawk index; server-to-server form prefill.
- [Change categories](https://ulawk.com/en/gelistirici/degisiklik-kategorileri.md): Every change and notice falls into a fixed category.
- [Webhooks](https://ulawk.com/en/gelistirici/webhooklar.md): Change notifications by category, signature verification, retries.
- [Rate limits](https://ulawk.com/en/gelistirici/hiz-sinirlari.md): 600 requests per key per hour; 429 and Retry-After.
- [Errors](https://ulawk.com/en/gelistirici/hatalar.md): One error model: hata, detay, hata_ayrinti.
- [Sandbox and test ids](https://ulawk.com/en/gelistirici/deneme-ortami.md): Test with made-up DENEME-… companies without touching live data.
- [MCP](https://ulawk.com/en/gelistirici/mcp.md): Ulawk tools for AI assistants.
- [Versioning policy](https://ulawk.com/en/gelistirici/surum-politikasi.md): v1 only grows by addition.

## Country guides

- [Country guides](https://ulawk.com/en/gelistirici/ulkeler.md): Identifiers, datapoints, documents and refresh by country.
- [Türkiye](https://ulawk.com/en/gelistirici/ulkeler/tr.md): Türkiye: Full coverage · Turkish Trade Registry Gazette + KAP
- [Bulgaria](https://ulawk.com/en/gelistirici/ulkeler/bg.md): Bulgaria: Full coverage · Official company register of Bulgaria
- [Czechia](https://ulawk.com/en/gelistirici/ulkeler/cz.md): Czechia: Full coverage · Official company register of Czechia
- [Estonia](https://ulawk.com/en/gelistirici/ulkeler/ee.md): Estonia: Full coverage · Official company register of Estonia
- [Latvia](https://ulawk.com/en/gelistirici/ulkeler/lv.md): Latvia: Full coverage · Official company register of Latvia
- [Norway](https://ulawk.com/en/gelistirici/ulkeler/no.md): Norway: Full coverage · Official company register of Norway
- [Poland](https://ulawk.com/en/gelistirici/ulkeler/pl.md): Poland: Full coverage · Official company register and official beneficial ownership register of Poland
- [Slovakia](https://ulawk.com/en/gelistirici/ulkeler/sk.md): Slovakia: Full coverage · Official company register of Slovakia
- [United Kingdom](https://ulawk.com/en/gelistirici/ulkeler/gb.md): United Kingdom: Full coverage · Official company register and official gazette of the United Kingdom
- [Croatia](https://ulawk.com/en/gelistirici/ulkeler/hr.md): Croatia: Registry record · Official company register of Croatia
- [Cyprus](https://ulawk.com/en/gelistirici/ulkeler/cy.md): Cyprus: Registry record · Official company register of Cyprus
- [Finland](https://ulawk.com/en/gelistirici/ulkeler/fi.md): Finland: Registry record · Official company register and official gazette of Finland
- [France](https://ulawk.com/en/gelistirici/ulkeler/fr.md): France: Registry record · Official company register and official gazette of France
- [Ireland](https://ulawk.com/en/gelistirici/ulkeler/ie.md): Ireland: Registry record · Official company register of Ireland
- [Lithuania](https://ulawk.com/en/gelistirici/ulkeler/lt.md): Lithuania: Registry record · Official company register of Lithuania
- [Luxembourg](https://ulawk.com/en/gelistirici/ulkeler/lu.md): Luxembourg: Registry record · Official annual accounts register of Luxembourg and international company identifier record (LEI)
- [Romania](https://ulawk.com/en/gelistirici/ulkeler/ro.md): Romania: Registry record · Official tax register of Romania
- [Spain](https://ulawk.com/en/gelistirici/ulkeler/es.md): Spain: Registry record · Official gazette of Spain
- [Sweden](https://ulawk.com/en/gelistirici/ulkeler/se.md): Sweden: Registry record · Official company register of Sweden
- [Switzerland](https://ulawk.com/en/gelistirici/ulkeler/ch.md): Switzerland: Registry record · Official gazette and official company register of Switzerland
- [Ukraine](https://ulawk.com/en/gelistirici/ulkeler/ua.md): Ukraine: Registry record · Official company register of Ukraine
- [Austria](https://ulawk.com/en/gelistirici/ulkeler/at.md): Austria: LEI record · International company identifier record (LEI)
- [Italy](https://ulawk.com/en/gelistirici/ulkeler/it.md): Italy: LEI record · International company identifier record (LEI)
- [Netherlands](https://ulawk.com/en/gelistirici/ulkeler/nl.md): Netherlands: LEI record · International company identifier record (LEI)
- [Taiwan](https://ulawk.com/en/gelistirici/ulkeler/tw.md): Taiwan: Full coverage · Official company register of Taiwan
- [Japan](https://ulawk.com/en/gelistirici/ulkeler/jp.md): Japan: Registry record · Official corporate record of Japan
- [Singapore](https://ulawk.com/en/gelistirici/ulkeler/sg.md): Singapore: Registry record · Official company register of Singapore
- [Australia](https://ulawk.com/en/gelistirici/ulkeler/au.md): Australia: Basic record · Official company register of Australia
- [United States](https://ulawk.com/en/gelistirici/ulkeler/us.md): United States: Full coverage · US securities filings and state company registers
- [Canada](https://ulawk.com/en/gelistirici/ulkeler/ca.md): Canada: Registry record · Official company register of Canada
- [Brazil](https://ulawk.com/en/gelistirici/ulkeler/br.md): Brazil: Registry record · Official company register of Brazil
- [Guernsey](https://ulawk.com/en/gelistirici/ulkeler/gg.md): Guernsey: Registry record · Official company register of Guernsey
- [Isle of Man](https://ulawk.com/en/gelistirici/ulkeler/im.md): Isle of Man: Registry record · Official company register of the Isle of Man
- [Jersey](https://ulawk.com/en/gelistirici/ulkeler/je.md): Jersey: Registry record · Official company register of Jersey
- [Liechtenstein](https://ulawk.com/en/gelistirici/ulkeler/li.md): Liechtenstein: Registry record · Official company register of Liechtenstein
- [Belize](https://ulawk.com/en/gelistirici/ulkeler/bz.md): Belize: Basic record · Official company register of Belize
- [Curaçao](https://ulawk.com/en/gelistirici/ulkeler/cw.md): Curaçao: Basic record · Official company register of Curaçao
- [Seychelles](https://ulawk.com/en/gelistirici/ulkeler/sc.md): Seychelles: Basic record · Official company register of the Seychelles
- [British Virgin Islands](https://ulawk.com/en/gelistirici/ulkeler/vg.md): British Virgin Islands: LEI record · International company identifier record (LEI)
- [Cayman Islands](https://ulawk.com/en/gelistirici/ulkeler/ky.md): Cayman Islands: LEI record · International company identifier record (LEI)
- [Mauritius](https://ulawk.com/en/gelistirici/ulkeler/mu.md): Mauritius: LEI record · International company identifier record (LEI)
- [Israel](https://ulawk.com/en/gelistirici/ulkeler/il.md): Israel: Registry record · Official company register of Israel

## API reference

- [API reference](https://ulawk.com/en/gelistirici/api.md): Ulawk API endpoints.
- [List followed companies](https://ulawk.com/en/gelistirici/api/sirketleri-listele.md): Companies you follow: id, name, registry office, registry number, notice count and profile link. Sorted by name and paginated.
- [Follow a company](https://ulawk.com/en/gelistirici/api/sirket-ekle.md): 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 t
- [Quick lookup (prefill)](https://ulawk.com/en/gelistirici/api/hizli-sorgu.md): Instant candidates from the Ulawk index: name, registry office, registry number, legal form, status, province, address, incorporation and latest notice date. On
- [Preparation status](https://ulawk.com/en/gelistirici/api/sirket-durumu.md): Preparation stage of a newly added company: notices → gazette archive → profile. Poll every few minutes until hazir . Branch records report sube directly.
- [Company profile](https://ulawk.com/en/gelistirici/api/sirket-profili.md): Full sourced profile: summary, identity, officers, capital, ownership, name/address, articles, one chronological change feed, notices and report findings. Every
- [Officers on a date](https://ulawk.com/en/gelistirici/api/yetkililer.md): Officers in office on the given date (title, representation, term, source). Without tarih , the current officers. Use it to check whether a signatory was author
- [Term expiries](https://ulawk.com/en/gelistirici/api/gorev-bitisleri.md): Officers across all your companies whose term ends within gun days or has lapsed without renewal (by days left). For reminders and calendar integrations.
- [Verification report](https://ulawk.com/en/gelistirici/api/dogrulama-raporu.md): A sealed verification report (PDF) built from the company's sourced profile. Every fact carries its source notice reference (date · issue · page) and a verbatim
- [Signing authority check](https://ulawk.com/en/gelistirici/api/imza-kontrol.md): "May this person represent the company on this date, for this transaction and amount?" The result is derived from representation decisions in the notices, terms
- [Signing check (query) and officer list](https://ulawk.com/en/gelistirici/api/imza-kontrol-sorgu.md): Without kisi it returns the officer names in the profile (in office first); with kisi it runs the same check as POST from query parameters ( birlikte may repeat
- [Company changes](https://ulawk.com/en/gelistirici/api/sirket-degisiklikleri.md): Every change with its source gazette: officer appointments/departures, capital, ownership, name/address, articles and status changes in one chronological feed (
- [Recent changes across companies](https://ulawk.com/en/gelistirici/api/gunluk-degisiklikler.md): Latest changes across all your companies in one feed, each row naming the company. Pull the daily changes with one request a day, or use webhooks instead.
- [Company notices](https://ulawk.com/en/gelistirici/api/ilanlar.md): The company's Trade Registry Gazette notices (newest first): date, type, issue/page, plain-language title and description, gazette PDF link and change category.
- [Gazette PDF](https://ulawk.com/en/gelistirici/api/ilan-pdf.md): PDF of the gazette the notice appeared in, from our archive. indir=1 downloads it as a file. If not archived yet: 404 arsivde_yok (retryable).
- [Gazette page image](https://ulawk.com/en/gelistirici/api/ilan-sayfasi.md): PNG image of page n of the gazette. Draw the proportional boxes in kaynak.vurgu.kutular on it to highlight where the fact appears.
- [All gazettes (ZIP)](https://ulawk.com/en/gelistirici/api/sirket-gazeteleri.md): All archived gazette PDFs of the company in one ZIP (file names carry date and notice type).
- [Gazette archive](https://ulawk.com/en/gelistirici/api/gazete-arsivi.md): Archived gazettes of all your notices: notice, company, gazette id, page count, size and PDF link. Paginated.
- [KAP disclosures](https://ulawk.com/en/gelistirici/api/kap.md): The matched KAP member, funds it founded and recent KAP disclosures of the company and its funds (subject, summary, attachments). No match: 404 kap_eslesmesi_yo
- [Reports](https://ulawk.com/en/gelistirici/api/raporlar.md): Your reports (paginated). For speed the list omits report content; findings come in the raporlar field of the company profile.
- [Report file](https://ulawk.com/en/gelistirici/api/rapor-dosyasi.md): Report file: rapor (PDF), sermaye (PDF), rapor-word (DOCX), sermaye-excel (XLSX), ek-excel (XLSX).
- [Sanctions screening](https://ulawk.com/en/gelistirici/api/yaptirim-tara.md): Screens up to 500 names against sanctions lists. Matching is exact-name only: every part of the name must match (ignoring order, accents and case). Results are 
- [List webhooks](https://ulawk.com/en/gelistirici/api/webhook-listesi.md): Your webhooks (without secrets) and the valid categories.
- [Create a webhook](https://ulawk.com/en/gelistirici/api/webhook-ekle.md): Creates a change webhook. https only; addresses resolving to private or local networks are rejected. Up to 5 addresses. Empty kategoriler = all categories. The 
- [Webhook detail](https://ulawk.com/en/gelistirici/api/webhook-ayrintisi.md): Webhook and its last 20 deliveries.
- [Update a webhook](https://ulawk.com/en/gelistirici/api/webhook-guncelle.md): aktif and/or kategoriler . Re-enabling resets the failure counter.
- [Delete a webhook](https://ulawk.com/en/gelistirici/api/webhook-sil.md): Deletes the webhook and its delivery log.
- [Send a test notification](https://ulawk.com/en/gelistirici/api/webhook-test.md): Sends one test notification with a made-up DENEME company ( "test": true in the body) and returns the result at once; not retried. If your endpoint does not ans
- [Coverage catalogue](https://ulawk.com/en/gelistirici/api/katalog.md): Coverage by country: identifiers, datapoints, documents, refresh and response time. Keyless, read-only, cached (Cache-Control). Only countries open to customers
- [Coverage of one country](https://ulawk.com/en/gelistirici/api/katalog-ulke.md): Catalogue entry of one country. Unknown or not yet open: 404.
- [Service status](https://ulawk.com/en/gelistirici/api/hizmet-durumu.md): Day-by-day status of Ulawk and its sources (dates only). Keyless, cached. Page version: /durum/.
- [Legacy company list](https://ulawk.com/en/gelistirici/api/eski-sirketler.md): Kept from the first version and still working. Use /api/v1/sirketler/ for new integrations. Does not accept sandbox keys.
- [Legacy profile](https://ulawk.com/en/gelistirici/api/eski-profil.md): Legacy profile endpoint, still working. Use /api/v1/sirketler/{sirket_id}/ for new integrations: source trail and veri_durumu are only there.

## Changelog

- [Changelog](https://ulawk.com/en/gelistirici/degisiklik-gunlugu.md): API and docs changes.