{
 "openapi": "3.1.0",
 "info": {
  "title": "Ulawk API",
  "version": "1.0.0",
  "summary": "Turkish trade registry monitoring: sourced profiles, changes, notices and gazettes.",
  "description": "Field names and values are in Turkish, as in the source records. Docs: /en/gelistirici/",
  "contact": {
   "name": "Ulawk",
   "email": "info@ulawk.com",
   "url": "https://ulawk.com/gelistirici/"
  }
 },
 "servers": [
  {
   "url": "https://ulawk.com"
  }
 ],
 "security": [
  {
   "anahtar": [],
   "gizli": []
  }
 ],
 "tags": [
  {
   "name": "sirketler",
   "description": "Following, adding, profiles and officers.",
   "x-displayName": "Companies"
  },
  {
   "name": "dogrulama",
   "description": "Sealed verification report and signing authority check.",
   "x-displayName": "Verification and signatures"
  },
  {
   "name": "degisiklikler",
   "description": "Sourced change feeds.",
   "x-displayName": "Changes"
  },
  {
   "name": "ilanlar",
   "description": "Notices, gazette PDFs, page images, KAP.",
   "x-displayName": "Notices and gazettes"
  },
  {
   "name": "raporlar",
   "description": "Reports and their files.",
   "x-displayName": "Reports"
  },
  {
   "name": "yaptirim",
   "description": "Exact-name screening.",
   "x-displayName": "Sanctions screening"
  },
  {
   "name": "webhooklar",
   "description": "Change notifications by category.",
   "x-displayName": "Webhooks"
  },
  {
   "name": "acik",
   "description": "Keyless endpoints: coverage catalogue and service status.",
   "x-displayName": "Public"
  },
  {
   "name": "eski",
   "description": "Older endpoints kept for compatibility.",
   "x-displayName": "Legacy"
  }
 ],
 "paths": {
  "/api/v1/sirketler/": {
   "get": {
    "operationId": "sirketleri-listele",
    "tags": [
     "sirketler"
    ],
    "summary": "List followed companies",
    "description": "Companies you follow: id, name, registry office, registry number, notice count and profile link. Sorted by name and paginated.",
    "parameters": [
     {
      "name": "sayfa",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      },
      "description": "Page number (from 1)."
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 1000,
       "default": 200
      },
      "description": "Records per page (default 200, max 1000)."
     }
    ],
    "responses": {
     "200": {
      "description": "Company list.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/SirketListesi"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/sirketleri-listele/"
   }
  },
  "/api/v1/sirket-ekle/": {
   "post": {
    "operationId": "sirket-ekle",
    "tags": [
     "sirketler"
    ],
    "summary": "Follow a company",
    "description": "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.",
    "parameters": [],
    "responses": {
     "201": {
      "description": "Followed (`eklendi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EklemeSonucu"
        }
       }
      }
     },
     "200": {
      "description": "Already on your list (`zaten_var`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EklemeSonucu"
        }
       }
      }
     },
     "400": {
      "description": "`eksik_alan` or `gecersiz_sicil`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "402": {
      "description": "Plan allowance used up (`kota_doldu`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "405": {
      "description": "POST expected (`yontem`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/sirket-ekle/",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "mudurluk": {
          "type": "string",
          "description": "Registry office (e.g. İSTANBUL)."
         },
         "sicil_no": {
          "type": "string",
          "description": "Registry number; starts with a digit.",
          "pattern": "^[0-9][0-9\\-/]{0,29}$"
         },
         "unvan": {
          "type": "string",
          "description": "Optional company name."
         }
        },
        "required": [
         "mudurluk",
         "sicil_no"
        ],
        "additionalProperties": false
       },
       "example": {
        "mudurluk": "İSTANBUL",
        "sicil_no": "555555"
       }
      }
     }
    }
   }
  },
  "/api/v1/ara/": {
   "get": {
    "operationId": "hizli-sorgu",
    "tags": [
     "sirketler"
    ],
    "summary": "Quick lookup (prefill)",
    "description": "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.",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 3
      },
      "description": "Name, registry number or id (at least 3 letters/digits).",
      "example": "örnek deneme"
     },
     {
      "name": "ulke",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$"
      },
      "description": "Country filter (TR, GB …); all if omitted.",
      "example": "TR"
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 20,
       "default": 10
      },
      "description": "Max candidates (default 10, max 20)."
     },
     {
      "name": "mudurluk",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Only this registry office (Turkey)."
     },
     {
      "name": "faal",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "1 → only companies whose status is FAAL."
     }
    ],
    "responses": {
     "200": {
      "description": "Candidates (may be empty).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HizliSorguYaniti"
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_parametre` (q too short, invalid ulke or adet).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "405": {
      "description": "GET expected (`yontem`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/hizli-sorgu/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/durum/": {
   "get": {
    "operationId": "sirket-durumu",
    "tags": [
     "sirketler"
    ],
    "summary": "Preparation status",
    "description": "Preparation stage of a newly added company: notices → gazette archive → profile. Poll every few minutes until `hazir`. Branch records report `sube` directly.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     }
    ],
    "responses": {
     "200": {
      "description": "Preparation status.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HazirlikDurumu"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/sirket-durumu/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/": {
   "get": {
    "operationId": "sirket-profili",
    "tags": [
     "sirketler"
    ],
    "summary": "Company profile",
    "description": "Full sourced profile: summary, identity, officers, capital, ownership, name/address, articles, one chronological change feed, notices and report findings. Every record carries `kaynak`. `veri_durumu` states how complete each section is; empty list `[]` = looked, none · `null` = not available or still being prepared.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     }
    ],
    "responses": {
     "200": {
      "description": "Profile.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Profil"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/sirket-profili/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/yetkililer/": {
   "get": {
    "operationId": "yetkililer",
    "tags": [
     "sirketler"
    ],
    "summary": "Officers on a date",
    "description": "Officers in office on the given date (title, representation, term, source). Without `tarih`, the current officers. Use it to check whether a signatory was authorised on that date.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     },
     {
      "name": "tarih",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "format": "date"
      },
      "description": "YYYY-MM-DD.",
      "example": "2021-06-01"
     }
    ],
    "responses": {
     "200": {
      "description": "Officers.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/YetkiliListesi"
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_tarih`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/yetkililer/"
   }
  },
  "/api/v1/gorev-bitisleri/": {
   "get": {
    "operationId": "gorev-bitisleri",
    "tags": [
     "sirketler"
    ],
    "summary": "Term expiries",
    "description": "Officers across all your companies whose term ends within `gun` days or has lapsed without renewal (by days left). For reminders and calendar integrations.",
    "parameters": [
     {
      "name": "gun",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 3650,
       "default": 120
      },
      "description": "Horizon (days).",
      "example": 180
     }
    ],
    "responses": {
     "200": {
      "description": "Term expiries.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/GorevBitisleri"
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_gun`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/gorev-bitisleri/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/dogrulama-raporu.pdf": {
   "get": {
    "operationId": "dogrulama-raporu",
    "tags": [
     "dogrulama"
    ],
    "summary": "Verification report",
    "description": "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 quote; the cover shows the seal: DOGRULANDI, KISMI or DOGRULANMADI. The report id is derived from the content: the same content gives the same id and can be re-downloaded free with `?rapor=DR-…`. `?bicim=json` returns the same content as JSON, `?bicim=html` as a printable page. `?tam_zorunlu=1`: 409 `veri_eksik` unless the seal is DOGRULANDI. Response headers: X-Ulawk-Rapor-Kimligi, X-Ulawk-Muhur, X-Ulawk-Icerik-Ozeti, X-Ulawk-Veri-Durumu.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     },
     {
      "name": "dil",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "en"
       ]
      },
      "description": "en → English report (default Turkish)."
     },
     {
      "name": "rapor",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "pattern": "^DR-"
      },
      "description": "Id of an earlier report: the same snapshot is redrawn."
     },
     {
      "name": "bicim",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "pdf",
        "json",
        "html"
       ],
       "default": "pdf"
      },
      "description": "Output format.",
      "example": "json"
     },
     {
      "name": "tam_zorunlu",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "1 → only a DOGRULANDI report, otherwise 409."
     },
     {
      "name": "indir",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "1 → download the PDF as a file."
     }
    ],
    "responses": {
     "200": {
      "description": "Report (PDF; ?bicim=json → JSON; ?bicim=html → HTML).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DogrulamaRaporuJson"
        }
       },
       "application/pdf": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       },
       "text/html": {
        "schema": {
         "type": "string"
        }
       }
      },
      "headers": {
       "X-Ulawk-Rapor-Kimligi": {
        "schema": {
         "type": "string"
        },
        "description": "DR-… report id."
       },
       "X-Ulawk-Muhur": {
        "schema": {
         "type": "string"
        },
        "description": "DOGRULANDI · KISMI · DOGRULANMADI"
       },
       "X-Ulawk-Icerik-Ozeti": {
        "schema": {
         "type": "string"
        },
        "description": "SHA-256 digest of the content."
       },
       "X-Ulawk-Veri-Durumu": {
        "schema": {
         "type": "string"
        },
        "description": "tam · kismi · hazirlaniyor"
       }
      }
     },
     "404": {
      "description": "Company or `?rapor=` id not found (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "409": {
      "description": "`?tam_zorunlu=1` and the seal is not DOGRULANDI (`veri_eksik`; `muhur`, `bekleyen_bolumler`, `rapor_kimligi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "PDF could not be produced right now (`pdf_uretilemedi`; try `?bicim=html`) or the source is unreachable.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/dogrulama-raporu/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/imza-kontrol/": {
   "post": {
    "operationId": "imza-kontrol",
    "tags": [
     "dogrulama"
    ],
    "summary": "Signing authority check",
    "description": "\"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 of office and, if published, the internal directive: `yetkili`, `yetkili_degil` or `belirsiz`. Every reason carries its source notice. Under joint representation pass co-signers in `birlikte`. Not legal advice; confirm against the current signature circular. The same input may also be sent as a GET query.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     }
    ],
    "responses": {
     "200": {
      "description": "Check result.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/ImzaKontrolSonucu"
        }
       }
      }
     },
     "400": {
      "description": "`eksik_parametre` (no kisi), `gecersiz_tarih`, `gecersiz_tutar`, `gecersiz_govde`, `gecersiz_parametre`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "405": {
      "description": "GET or POST expected (`yontem`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/imza-kontrol/",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "kisi": {
          "type": "string",
          "description": "Officer full name (required; case and accents ignored)."
         },
         "tarih": {
          "type": "string",
          "description": "Signing date YYYY-MM-DD (default today).",
          "format": "date"
         },
         "tutar": {
          "type": [
           "number",
           "string"
          ],
          "description": "Transaction amount (1500000 or \"1.500.000,00\"); compared with the directive limit."
         },
         "para_birimi": {
          "type": "string",
          "description": "Default TRY.",
          "default": "TRY"
         },
         "islem": {
          "type": "string",
          "description": "Transaction type (e.g. loan, sale); empty = general representation."
         },
         "birlikte": {
          "type": "array",
          "description": "Names of co-signers (joint representation; max 10).",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "kisi"
        ],
        "additionalProperties": false
       },
       "example": {
        "kisi": "Ayşe Örnek",
        "tarih": "2026-10-01",
        "tutar": 1500000,
        "islem": "kredi"
       }
      }
     }
    }
   },
   "get": {
    "operationId": "imza-kontrol-sorgu",
    "tags": [
     "dogrulama"
    ],
    "summary": "Signing check (query) and officer list",
    "description": "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 or be comma-separated).",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     },
     {
      "name": "kisi",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Officer full name.",
      "example": "Ayşe Örnek"
     },
     {
      "name": "tarih",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "format": "date"
      },
      "description": "YYYY-MM-DD (default today)."
     },
     {
      "name": "tutar",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Transaction amount."
     },
     {
      "name": "para_birimi",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "default": "TRY"
      },
      "description": "Currency."
     },
     {
      "name": "islem",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Transaction type."
     },
     {
      "name": "birlikte",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Co-signers (comma-separated)."
     }
    ],
    "responses": {
     "200": {
      "description": "Officer list without `kisi`, check result with it.",
      "content": {
       "application/json": {
        "schema": {
         "anyOf": [
          {
           "$ref": "#/components/schemas/ImzaKontrolSonucu"
          },
          {
           "$ref": "#/components/schemas/ImzaKisiListesi"
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_tarih`, `gecersiz_tutar`, `gecersiz_parametre`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/imza-kontrol-sorgu/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/degisiklikler/": {
   "get": {
    "operationId": "sirket-degisiklikleri",
    "tags": [
     "degisiklikler"
    ],
    "summary": "Company changes",
    "description": "Every change with its source gazette: officer appointments/departures, capital, ownership, name/address, articles and status changes in one chronological feed (newest first). Also returns `son_gazete`.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     },
     {
      "name": "tur",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "yetkili-atama",
        "yetkili-ayrilma",
        "sermaye",
        "ortaklik",
        "unvan-adres",
        "esas-sozlesme",
        "durum"
       ]
      },
      "description": "Change type filter."
     },
     {
      "name": "kategoriler",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated change category filter: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi. Unknown category → 400 `gecersiz_kategori`.",
      "example": "durum,yetkililer"
     },
     {
      "name": "sayfa",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      },
      "description": "Page number (from 1)."
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 100
      },
      "description": "Records per page (default 100, max 500)."
     }
    ],
    "responses": {
     "200": {
      "description": "Changes.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DegisiklikListesi"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/sirket-degisiklikleri/"
   }
  },
  "/api/v1/degisiklikler/": {
   "get": {
    "operationId": "gunluk-degisiklikler",
    "tags": [
     "degisiklikler"
    ],
    "summary": "Recent changes across companies",
    "description": "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.",
    "parameters": [
     {
      "name": "gun",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 365,
       "default": 1
      },
      "description": "How many days back.",
      "example": 7
     },
     {
      "name": "tur",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "yetkili-atama",
        "yetkili-ayrilma",
        "sermaye",
        "ortaklik",
        "unvan-adres",
        "esas-sozlesme",
        "durum"
       ]
      },
      "description": "Change type filter."
     },
     {
      "name": "kategoriler",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated change category filter: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi. Unknown category → 400 `gecersiz_kategori`.",
      "example": "durum,yetkililer"
     },
     {
      "name": "sayfa",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      },
      "description": "Page number (from 1)."
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 200
      },
      "description": "Records per page (default 200, max 500)."
     }
    ],
    "responses": {
     "200": {
      "description": "Changes.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/GunlukDegisiklikListesi"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/gunluk-degisiklikler/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/ilanlar/": {
   "get": {
    "operationId": "ilanlar",
    "tags": [
     "ilanlar"
    ],
    "summary": "Company notices",
    "description": "The company's Trade Registry Gazette notices (newest first): date, type, issue/page, plain-language title and description, gazette PDF link and change category.",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     },
     {
      "name": "kategori",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated notice-type category (legacy filter): kurulus, konkordato, birlesme, sermaye, ortaklik, yonetim, unvan_adres, genel_kurul, esas, diger."
     },
     {
      "name": "kategoriler",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated change category filter: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi. Unknown category → 400 `gecersiz_kategori`.",
      "example": "durum,yetkililer"
     }
    ],
    "responses": {
     "200": {
      "description": "Notices.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/IlanListesi"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/ilanlar/"
   }
  },
  "/api/v1/ilanlar/{ilan_id}/pdf/": {
   "get": {
    "operationId": "ilan-pdf",
    "tags": [
     "ilanlar"
    ],
    "summary": "Gazette PDF",
    "description": "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).",
    "parameters": [
     {
      "name": "ilan_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Notice id (`ilanlar[].ilan_id` or `kaynak.ilan_id`).",
      "example": 9000000
     },
     {
      "name": "indir",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "1 → download as attachment."
     }
    ],
    "responses": {
     "200": {
      "description": "PDF file.",
      "content": {
       "application/pdf": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "404": {
      "description": "`bulunamadi` or `arsivde_yok`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/ilan-pdf/"
   }
  },
  "/api/v1/ilanlar/{ilan_id}/sayfa/{sayfa}/": {
   "get": {
    "operationId": "ilan-sayfasi",
    "tags": [
     "ilanlar"
    ],
    "summary": "Gazette page image",
    "description": "PNG image of page n of the gazette. Draw the proportional boxes in `kaynak.vurgu.kutular` on it to highlight where the fact appears.",
    "parameters": [
     {
      "name": "ilan_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Notice id (`ilanlar[].ilan_id` or `kaynak.ilan_id`).",
      "example": 9000000
     },
     {
      "name": "sayfa",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer",
       "minimum": 1
      },
      "description": "Page number (`kaynak.vurgu.sayfa`).",
      "example": 1
     }
    ],
    "responses": {
     "200": {
      "description": "PNG image.",
      "content": {
       "image/png": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/ilan-sayfasi/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/pdfler/": {
   "get": {
    "operationId": "sirket-gazeteleri",
    "tags": [
     "ilanlar"
    ],
    "summary": "All gazettes (ZIP)",
    "description": "All archived gazette PDFs of the company in one ZIP (file names carry date and notice type).",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     }
    ],
    "responses": {
     "200": {
      "description": "ZIP file.",
      "content": {
       "application/zip": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "404": {
      "description": "`bulunamadi` or `arsivde_yok`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/sirket-gazeteleri/"
   }
  },
  "/api/v1/gazeteler/": {
   "get": {
    "operationId": "gazete-arsivi",
    "tags": [
     "ilanlar"
    ],
    "summary": "Gazette archive",
    "description": "Archived gazettes of all your notices: notice, company, gazette id, page count, size and PDF link. Paginated.",
    "parameters": [
     {
      "name": "sayfa",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      },
      "description": "Page number (from 1)."
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 500,
       "default": 100
      },
      "description": "Records per page (default 100, max 500)."
     }
    ],
    "responses": {
     "200": {
      "description": "Gazettes.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/GazeteListesi"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/gazete-arsivi/"
   }
  },
  "/api/v1/sirketler/{sirket_id}/kap/": {
   "get": {
    "operationId": "kap",
    "tags": [
     "ilanlar"
    ],
    "summary": "KAP disclosures",
    "description": "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_yok` (taraf kaynak, kaynak kap).",
    "parameters": [
     {
      "name": "sirket_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": [
        "integer",
        "string"
       ],
       "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
      },
      "description": "Company id (`id` from `/api/v1/sirketler/`).",
      "example": "DENEME-100001"
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 50
      },
      "description": "Maximum disclosures."
     }
    ],
    "responses": {
     "200": {
      "description": "KAP data.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/KapYaniti"
        }
       }
      }
     },
     "404": {
      "description": "`bulunamadi` or `kap_eslesmesi_yok`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "503": {
      "description": "The official source is unreachable right now (`kaynak_erisilemiyor`, taraf kaynak). Sandbox: DENEME-KAYNAK-KAPALI.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/kap/"
   }
  },
  "/api/v1/raporlar/": {
   "get": {
    "operationId": "raporlar",
    "tags": [
     "raporlar"
    ],
    "summary": "Reports",
    "description": "Your reports (paginated). For speed the list omits report content; findings come in the `raporlar` field of the company profile.",
    "parameters": [
     {
      "name": "sayfa",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "default": 1
      },
      "description": "Page number (from 1)."
     },
     {
      "name": "adet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 200,
       "default": 50
      },
      "description": "Records per page (default 50, max 200)."
     }
    ],
    "responses": {
     "200": {
      "description": "Reports.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/RaporListesi"
        }
       }
      }
     },
     "400": {
      "description": "Invalid parameter (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) or the endpoint does not support sandbox keys (`deneme_desteklenmiyor`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/raporlar/"
   }
  },
  "/api/v1/raporlar/{rapor_id}/{tur}/": {
   "get": {
    "operationId": "rapor-dosyasi",
    "tags": [
     "raporlar"
    ],
    "summary": "Report file",
    "description": "Report file: `rapor` (PDF), `sermaye` (PDF), `rapor-word` (DOCX), `sermaye-excel` (XLSX), `ek-excel` (XLSX).",
    "parameters": [
     {
      "name": "rapor_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Report id.",
      "example": 1
     },
     {
      "name": "tur",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "rapor",
        "sermaye",
        "rapor-word",
        "sermaye-excel",
        "ek-excel"
       ]
      },
      "description": "File type.",
      "example": "rapor"
     }
    ],
    "responses": {
     "200": {
      "description": "File.",
      "content": {
       "application/pdf": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       },
       "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       },
       "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/rapor-dosyasi/"
   }
  },
  "/api/v1/yaptirim/tara/": {
   "post": {
    "operationId": "yaptirim-tara",
    "tags": [
     "yaptirim"
    ],
    "summary": "Sanctions screening",
    "description": "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 possible hits; verify identity against the list entry. Not available with sandbox keys (401). `benzer_yazim` is accepted for compatibility and does not widen matching.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Screening result.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/YaptirimTaramasi"
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_json`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiHata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "405": {
      "description": "POST expected.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiHata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": false,
    "x-ulawk-belge": "/gelistirici/api/yaptirim-tara/",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "adlar": {
          "type": "array",
          "description": "Name or {ad, tur} (max 500).",
          "items": {
           "anyOf": [
            {
             "type": "string"
            },
            {
             "type": "object",
             "properties": {
              "ad": {
               "type": "string"
              },
              "tur": {
               "type": "string",
               "enum": [
                "kisi",
                "kurum"
               ]
              }
             },
             "required": [
              "ad"
             ],
             "additionalProperties": false
            }
           ]
          },
          "maxItems": 500
         },
         "benzer_yazim": {
          "type": "boolean",
          "description": "Compatibility only; no effect.",
          "default": true
         }
        },
        "required": [
         "adlar"
        ],
        "additionalProperties": false
       },
       "example": {
        "adlar": [
         "Ayşe Örnek",
         {
          "ad": "Örnek Deneme A.Ş.",
          "tur": "kurum"
         }
        ]
       }
      }
     }
    }
   }
  },
  "/api/v1/webhooklar/": {
   "get": {
    "operationId": "webhook-listesi",
    "tags": [
     "webhooklar"
    ],
    "summary": "List webhooks",
    "description": "Your webhooks (without secrets) and the valid categories.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Webhooks.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/WebhookListesi"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/webhook-listesi/"
   },
   "post": {
    "operationId": "webhook-ekle",
    "tags": [
     "webhooklar"
    ],
    "summary": "Create a webhook",
    "description": "Creates a change webhook. `https` only; addresses resolving to private or local networks are rejected. Up to 5 addresses. Empty `kategoriler` = all categories. The `gizli` signing secret is shown only in this response. API key only (session cookies are not accepted).",
    "parameters": [],
    "responses": {
     "201": {
      "description": "Webhook and its secret.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/YeniWebhook"
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_json` or `gecersiz_webhook` (address, category, limit).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "403": {
      "description": "API key required (`anahtar_gerekli`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/webhook-ekle/",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string",
          "description": "https URL (max 500 characters).",
          "format": "uri"
         },
         "kategoriler": {
          "type": "array",
          "description": "Subscribed categories.",
          "items": {
           "type": "string",
           "enum": [
            "durum",
            "adres",
            "ortaklik",
            "sermaye",
            "yetkililer",
            "unvan",
            "esas_sozlesme",
            "diger",
            "kapandi"
           ]
          }
         }
        },
        "required": [
         "url"
        ],
        "additionalProperties": false
       },
       "example": {
        "url": "https://sisteminiz.ornek.com/ulawk",
        "kategoriler": [
         "durum",
         "yetkililer"
        ]
       }
      }
     }
    }
   }
  },
  "/api/v1/webhooklar/{webhook_id}/": {
   "get": {
    "operationId": "webhook-ayrintisi",
    "tags": [
     "webhooklar"
    ],
    "summary": "Webhook detail",
    "description": "Webhook and its last 20 deliveries.",
    "parameters": [
     {
      "name": "webhook_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Webhook id.",
      "example": 1
     }
    ],
    "responses": {
     "200": {
      "description": "Webhook.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Webhook"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/webhook-ayrintisi/"
   },
   "patch": {
    "operationId": "webhook-guncelle",
    "tags": [
     "webhooklar"
    ],
    "summary": "Update a webhook",
    "description": "`aktif` and/or `kategoriler`. Re-enabling resets the failure counter.",
    "parameters": [
     {
      "name": "webhook_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Webhook id.",
      "example": 1
     }
    ],
    "responses": {
     "200": {
      "description": "Updated webhook.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Webhook"
        }
       }
      }
     },
     "400": {
      "description": "`gecersiz_json` or `gecersiz_webhook`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "403": {
      "description": "`anahtar_gerekli`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/webhook-guncelle/",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "aktif": {
          "type": "boolean"
         },
         "kategoriler": {
          "type": "array",
          "items": {
           "type": "string",
           "enum": [
            "durum",
            "adres",
            "ortaklik",
            "sermaye",
            "yetkililer",
            "unvan",
            "esas_sozlesme",
            "diger",
            "kapandi"
           ]
          }
         }
        },
        "required": [],
        "additionalProperties": false
       },
       "example": {
        "aktif": true,
        "kategoriler": [
         "durum",
         "kapandi"
        ]
       }
      }
     }
    }
   },
   "delete": {
    "operationId": "webhook-sil",
    "tags": [
     "webhooklar"
    ],
    "summary": "Delete a webhook",
    "description": "Deletes the webhook and its delivery log.",
    "parameters": [
     {
      "name": "webhook_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Webhook id.",
      "example": 1
     }
    ],
    "responses": {
     "200": {
      "description": "Deleted.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/WebhookSilindi"
        }
       }
      }
     },
     "403": {
      "description": "`anahtar_gerekli`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/webhook-sil/"
   }
  },
  "/api/v1/webhooklar/{webhook_id}/test/": {
   "post": {
    "operationId": "webhook-test",
    "tags": [
     "webhooklar"
    ],
    "summary": "Send a test notification",
    "description": "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 answer 2xx: 502 `webhook_teslim_hatasi`.",
    "parameters": [
     {
      "name": "webhook_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Webhook id.",
      "example": 1
     }
    ],
    "responses": {
     "200": {
      "description": "Delivered.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/WebhookTestSonucu"
        }
       }
      }
     },
     "403": {
      "description": "`anahtar_gerekli`.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "404": {
      "description": "Not found or no access (`bulunamadi`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "502": {
      "description": "Your endpoint did not answer 2xx; `teslim` has details.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "401": {
      "description": "Missing or invalid key (`yetkisiz`).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "429": {
      "description": "Hourly rate limit exceeded (`hiz_siniri`); the Retry-After header gives the seconds until reset.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     },
     "500": {
      "description": "Unexpected error (`ic_hata`, taraf ulawk); retry shortly.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Hata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/webhook-test/"
   }
  },
  "/api/katalog/": {
   "get": {
    "operationId": "katalog",
    "tags": [
     "acik"
    ],
    "summary": "Coverage catalogue",
    "description": "Coverage by country: identifiers, datapoints, documents, refresh and response time. Keyless, read-only, cached (Cache-Control). Only countries open to customers.",
    "parameters": [
     {
      "name": "dil",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "tr",
        "en"
       ],
       "default": "tr"
      },
      "description": "Language of the texts."
     }
    ],
    "responses": {
     "200": {
      "description": "Catalogue.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Katalog"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/katalog/",
    "security": []
   }
  },
  "/api/katalog/{kod}/": {
   "get": {
    "operationId": "katalog-ulke",
    "tags": [
     "acik"
    ],
    "summary": "Coverage of one country",
    "description": "Catalogue entry of one country. Unknown or not yet open: 404.",
    "parameters": [
     {
      "name": "kod",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$"
      },
      "description": "ISO 3166-1 alpha-2 code.",
      "example": "TR"
     },
     {
      "name": "dil",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "tr",
        "en"
       ],
       "default": "tr"
      },
      "description": "Language of the texts."
     }
    ],
    "responses": {
     "200": {
      "description": "Country entry.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/KatalogUlke"
        }
       }
      }
     },
     "404": {
      "description": "Country not found.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/BasitHata"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/katalog-ulke/",
    "security": []
   }
  },
  "/durum.json": {
   "get": {
    "operationId": "hizmet-durumu",
    "tags": [
     "acik"
    ],
    "summary": "Service status",
    "description": "Day-by-day status of Ulawk and its sources (dates only). Keyless, cached. Page version: /durum/.",
    "parameters": [
     {
      "name": "dil",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "tr",
        "en"
       ],
       "default": "tr"
      },
      "description": "Language of the texts."
     },
     {
      "name": "gun",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "enum": [
        30,
        60,
        90
       ],
       "default": 90
      },
      "description": "Days of history."
     }
    ],
    "responses": {
     "200": {
      "description": "Status.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HizmetDurumu"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": true,
    "x-ulawk-belge": "/gelistirici/api/hizmet-durumu/",
    "security": []
   }
  },
  "/api/v1/companies": {
   "get": {
    "operationId": "eski-sirketler",
    "tags": [
     "eski"
    ],
    "summary": "Legacy company list",
    "description": "Kept from the first version and still working. Use `/api/v1/sirketler/` for new integrations. Does not accept sandbox keys.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Companies.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiSirketListesi"
        }
       }
      }
     },
     "401": {
      "description": "Unauthorized.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiHataEn"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": false,
    "x-ulawk-belge": "/gelistirici/api/eski-sirketler/",
    "deprecated": true
   }
  },
  "/api/v1/company/{group_id}/profile": {
   "get": {
    "operationId": "eski-profil",
    "tags": [
     "eski"
    ],
    "summary": "Legacy profile",
    "description": "Legacy profile endpoint, still working. Use `/api/v1/sirketler/{sirket_id}/` for new integrations: source trail and `veri_durumu` are only there.",
    "parameters": [
     {
      "name": "group_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer"
      },
      "description": "Company id.",
      "example": 1
     }
    ],
    "responses": {
     "200": {
      "description": "Profile.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiProfil"
        }
       }
      }
     },
     "401": {
      "description": "Unauthorized.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiHataEn"
        }
       }
      }
     },
     "404": {
      "description": "Not found or profile not ready.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/EskiHataEn"
        }
       }
      }
     }
    },
    "x-ulawk-deneme": false,
    "x-ulawk-belge": "/gelistirici/api/eski-profil/",
    "deprecated": true
   }
  }
 },
 "webhooks": {
  "sirket.degisiklik": {
   "post": {
    "operationId": "webhook-sirket-degisiklik",
    "summary": "Change notification",
    "description": "Sent when a followed company changes in a subscribed category, one request per company. Headers: X-Ulawk-Imza (t=…,v1=…), X-Ulawk-Teslim, X-Ulawk-Olay.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/WebhookYuku"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Answer 2xx quickly; do the work afterwards."
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "HataAyrinti": {
    "type": "object",
    "properties": {
     "kod": {
      "type": "string",
      "description": "Machine-readable error code (same as `hata`)."
     },
     "mesaj": {
      "type": "string",
      "description": "Human-readable message (same as `detay`)."
     },
     "taraf": {
      "type": "string",
      "description": "Where the fault lies: istemci (request, key, plan), ulawk (our side), kaynak (the official source is unreachable right now).",
      "enum": [
       "istemci",
       "ulawk",
       "kaynak"
      ]
     },
     "kaynak": {
      "type": [
       "string",
       "null"
      ],
      "description": "Which source, for source-side errors; otherwise null.",
      "enum": [
       "ttsg",
       "kap",
       "yurt_disi_sicil",
       null
      ]
     },
     "tekrar_denenebilir": {
      "type": "boolean",
      "description": "Whether the same request may be retried later."
     },
     "tekrar_sn": {
      "type": [
       "integer",
       "null"
      ],
      "description": "Suggested wait in seconds. When set, a Retry-After header is sent too."
     }
    },
    "required": [
     "kod",
     "mesaj",
     "taraf",
     "kaynak",
     "tekrar_denenebilir",
     "tekrar_sn"
    ],
    "additionalProperties": false
   },
   "Hata": {
    "type": "object",
    "properties": {
     "hata": {
      "type": "string",
      "description": "Error code (kept for older clients; stable)."
     },
     "detay": {
      "type": "string",
      "description": "Message."
     },
     "hata_ayrinti": {
      "$ref": "#/components/schemas/HataAyrinti"
     },
     "gecerli_kategoriler": {
      "type": "array",
      "description": "Only with `gecersiz_kategori`.",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "teslim": {
      "$ref": "#/components/schemas/Teslim"
     },
     "muhur": {
      "type": "string",
      "description": "Only with `veri_eksik` (409): the report seal.",
      "enum": [
       "DOGRULANDI",
       "KISMI",
       "DOGRULANMADI"
      ]
     },
     "bekleyen_bolumler": {
      "type": "array",
      "description": "Only with `veri_eksik`: partial or in-preparation sections.",
      "items": {
       "type": "string"
      }
     },
     "rapor_kimligi": {
      "type": "string",
      "description": "Only with `veri_eksik`: report id of the current content."
     }
    },
    "required": [
     "hata",
     "detay",
     "hata_ayrinti"
    ],
    "additionalProperties": false,
    "description": "Single error body: `hata` + `detay` (backward compatible) and structured `hata_ayrinti`."
   },
   "EskiHata": {
    "type": "object",
    "properties": {
     "hata": {
      "type": "string"
     },
     "detay": {
      "type": "string"
     }
    },
    "required": [
     "hata"
    ],
    "additionalProperties": false,
    "description": "Error body of sanctions screening (no `hata_ayrinti`)."
   },
   "SirketOzet": {
    "type": "object",
    "properties": {
     "id": {
      "type": [
       "integer",
       "string"
      ],
      "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
     },
     "unvan": {
      "type": [
       "string",
       "null"
      ],
      "description": "Registered name."
     },
     "mudurluk": {
      "type": [
       "string",
       "null"
      ],
      "description": "Registry office (e.g. İSTANBUL)."
     },
     "sicil_no": {
      "type": [
       "string",
       "null"
      ],
      "description": "Trade registry number."
     }
    },
    "required": [
     "id",
     "unvan",
     "mudurluk",
     "sicil_no"
    ],
    "additionalProperties": false
   },
   "Vurgu": {
    "type": "object",
    "properties": {
     "sayfa": {
      "type": "integer",
      "description": "Gazette page (from 1)."
     },
     "sayfa_gorsel": {
      "type": "string",
      "description": "PNG image of the page.",
      "format": "uri"
     },
     "kutular": {
      "type": "array",
      "description": "Where the fact sits on the page: proportional [x0, y0, x1, y1] boxes (0–1, top-left origin).",
      "items": {
       "type": "array",
       "items": {
        "type": "number"
       },
       "minItems": 4,
       "maxItems": 4
      }
     },
     "kutu_birimi": {
      "type": "string",
      "description": "Description of the box unit."
     }
    },
    "required": [
     "sayfa",
     "sayfa_gorsel",
     "kutular",
     "kutu_birimi"
    ],
    "additionalProperties": false
   },
   "Kaynak": {
    "type": "object",
    "properties": {
     "ilan_id": {
      "type": "integer",
      "description": "The notice the fact comes from."
     },
     "ilan_tarihi": {
      "type": "string",
      "description": "Publication date of the notice.",
      "format": "date"
     },
     "ilan_turu": {
      "type": "string",
      "description": "Trade Registry Gazette notice type."
     },
     "alinti": {
      "type": "string",
      "description": "Verbatim quote from the notice text."
     },
     "alinti_dogrulandi": {
      "type": "boolean",
      "description": "Whether the quote was found verbatim in the notice."
     },
     "gazete_pdf": {
      "type": "string",
      "description": "Gazette PDF.",
      "format": "uri"
     },
     "vurgu": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Vurgu"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "ilan_id",
     "ilan_tarihi",
     "ilan_turu",
     "alinti",
     "alinti_dogrulandi",
     "gazete_pdf",
     "vurgu"
    ],
    "additionalProperties": false,
    "description": "Source trail: the notice behind the fact, a verbatim quote and the gazette link."
   },
   "HukukiBicim": {
    "type": "object",
    "properties": {
     "kod": {
      "type": "string",
      "description": "Standard form code (e.g. TR_AS)."
     },
     "yerel_ad": {
      "type": "string"
     },
     "kisaltma": {
      "type": "string"
     },
     "en_ad": {
      "type": "string"
     },
     "standart_kategori": {
      "description": "General class of the form."
     },
     "iso20275": {
      "type": [
       "string",
       "null"
      ],
      "description": "ISO 20275 (ELF) code when verified."
     },
     "iso20275_liste": {
      "type": [
       "string",
       "null"
      ]
     },
     "ulke": {
      "type": [
       "string",
       "null"
      ]
     },
     "ana_bicim": {
      "type": [
       "object",
       "null"
      ]
     },
     "girdi": {
      "type": "string"
     }
    },
    "required": [
     "kod"
    ],
    "additionalProperties": true,
    "description": "Legal form mapped from the name and notice type by fixed rules."
   },
   "Rol": {
    "type": "object",
    "properties": {
     "kod": {
      "type": "string"
     },
     "ad": {
      "type": "string"
     },
     "en_ad": {
      "type": "string"
     },
     "organ": {
      "type": [
       "string",
       "null"
      ]
     },
     "temsil_organi": {
      "type": [
       "boolean",
       "null"
      ]
     },
     "kesin": {
      "type": "boolean"
     },
     "roller": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "imza_derecesi": {
      "type": [
       "string",
       "null"
      ]
     },
     "iso5009": {
      "type": [
       "string",
       "null"
      ]
     },
     "iso5009_liste": {
      "type": [
       "string",
       "null"
      ]
     },
     "yerel_ad": {
      "type": "string"
     }
    },
    "required": [
     "kod"
    ],
    "additionalProperties": true,
    "description": "Standard role mapped from the title in the notice."
   },
   "Kimlik": {
    "type": "object",
    "properties": {
     "unvan": {
      "type": [
       "string",
       "null"
      ]
     },
     "tur": {
      "type": [
       "string",
       "null"
      ],
      "description": "Company type (e.g. Anonim Şirket)."
     },
     "merkez": {
      "type": [
       "string",
       "null"
      ],
      "description": "Registered office."
     },
     "kurulus_tarihi": {
      "type": [
       "string",
       "null"
      ],
      "description": "Incorporation date (YYYY-MM-DD; \"… or earlier\" when no incorporation notice)."
     },
     "sermaye": {
      "type": [
       "string",
       "null"
      ]
     },
     "durum": {
      "type": [
       "string",
       "null"
      ],
      "description": "Status from notices."
     },
     "durum_aciklama": {
      "type": [
       "string",
       "null"
      ]
     },
     "kurulus_supheli": {
      "type": "boolean",
      "description": "No incorporation notice; date from the oldest notice."
     },
     "kurulus_kaynak": {
      "type": [
       "object",
       "null"
      ]
     },
     "hukuki_bicim_standart": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/HukukiBicim"
       },
       {
        "type": "null"
       }
      ]
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "kaynak"
    ],
    "additionalProperties": true,
    "description": "Identity section. Fields may be added over time."
   },
   "Yetkili": {
    "type": "object",
    "properties": {
     "isim": {
      "type": [
       "string",
       "null"
      ]
     },
     "sifat": {
      "type": [
       "string",
       "null"
      ],
      "description": "Title in the notice."
     },
     "temsil": {
      "type": [
       "string",
       "null"
      ],
      "description": "Representation (sole, joint…)."
     },
     "baslangic": {
      "type": [
       "string",
       "null"
      ],
      "description": "Start of office.",
      "format": "date"
     },
     "bitis": {
      "type": [
       "string",
       "null"
      ],
      "description": "End of office; null while in office.",
      "format": "date"
     },
     "bitis_nedeni": {
      "type": [
       "string",
       "null"
      ]
     },
     "gorev_bitis": {
      "type": [
       "string",
       "null"
      ],
      "description": "Expected end of term."
     },
     "gorev_suresi": {
      "type": [
       "string",
       "null"
      ]
     },
     "gorev_dayanak": {
      "type": [
       "string",
       "null"
      ],
      "description": "Basis of the term end (notice or statute)."
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     },
     "bitis_kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     },
     "gorevde": {
      "type": "boolean",
      "description": "Whether in office today."
     },
     "rol_standart": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Rol"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "isim",
     "sifat",
     "temsil",
     "baslangic",
     "bitis",
     "bitis_nedeni",
     "gorev_bitis",
     "gorev_suresi",
     "gorev_dayanak",
     "kaynak",
     "bitis_kaynak",
     "gorevde"
    ],
    "additionalProperties": false
   },
   "SermayeKaydi": {
    "type": "object",
    "properties": {
     "tarih": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "islem": {
      "type": [
       "string",
       "null"
      ]
     },
     "onceki": {
      "type": [
       "string",
       "null"
      ]
     },
     "yeni": {
      "type": [
       "string",
       "null"
      ]
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "tarih",
     "islem",
     "onceki",
     "yeni",
     "kaynak"
    ],
    "additionalProperties": false
   },
   "OrtaklikKaydi": {
    "type": "object",
    "properties": {
     "tarih": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "isim": {
      "type": [
       "string",
       "null"
      ]
     },
     "pay_tutari": {
      "type": [
       "string",
       "null"
      ]
     },
     "pay_orani": {
      "type": [
       "string",
       "null"
      ]
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "tarih",
     "isim",
     "pay_tutari",
     "pay_orani",
     "kaynak"
    ],
    "additionalProperties": false
   },
   "UnvanAdresKaydi": {
    "type": "object",
    "properties": {
     "tarih": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "tur": {
      "type": [
       "string",
       "null"
      ],
      "description": "unvan (name) or adres (address)"
     },
     "deger": {
      "type": [
       "string",
       "null"
      ]
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "tarih",
     "tur",
     "deger",
     "kaynak"
    ],
    "additionalProperties": false
   },
   "EsasSozlesmeMaddesi": {
    "type": "object",
    "properties": {
     "madde": {
      "type": [
       "string",
       "null"
      ]
     },
     "baslik": {
      "type": [
       "string",
       "null"
      ]
     },
     "hukum": {
      "type": [
       "string",
       "null"
      ],
      "description": "AI summary of the current wording; see the source for the verbatim text."
     },
     "son_degisiklik": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "required": [
     "madde",
     "baslik",
     "hukum",
     "son_degisiklik",
     "kaynak"
    ],
    "additionalProperties": false
   },
   "Degisiklik": {
    "type": "object",
    "properties": {
     "tur": {
      "type": "string",
      "description": "Change type.",
      "enum": [
       "yetkili-atama",
       "yetkili-ayrilma",
       "sermaye",
       "ortaklik",
       "unvan-adres",
       "esas-sozlesme",
       "durum"
      ]
     },
     "tarih": {
      "type": [
       "string",
       "null"
      ],
      "description": "Date of the change.",
      "format": "date"
     },
     "ozet": {
      "type": "string",
      "description": "One-line summary."
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     },
     "gazete_pdf": {
      "type": [
       "string",
       "null"
      ],
      "description": "PDF of the source gazette.",
      "format": "uri"
     },
     "kategori": {
      "type": "string",
      "description": "Fixed change category.",
      "enum": [
       "durum",
       "adres",
       "ortaklik",
       "sermaye",
       "yetkililer",
       "unvan",
       "esas_sozlesme",
       "diger",
       "kapandi"
      ]
     },
     "isim": {
      "type": [
       "string",
       "null"
      ]
     },
     "sifat": {
      "type": [
       "string",
       "null"
      ]
     },
     "onceki": {
      "type": [
       "string",
       "null"
      ]
     },
     "yeni": {
      "type": [
       "string",
       "null"
      ]
     },
     "pay_tutari": {
      "type": [
       "string",
       "null"
      ]
     },
     "pay_orani": {
      "type": [
       "string",
       "null"
      ]
     },
     "alan": {
      "type": [
       "string",
       "null"
      ]
     },
     "deger": {
      "type": [
       "string",
       "null"
      ]
     },
     "madde": {
      "type": [
       "string",
       "null"
      ]
     },
     "baslik": {
      "type": [
       "string",
       "null"
      ]
     },
     "aciklama": {
      "type": [
       "string",
       "null"
      ]
     }
    },
    "required": [
     "tur",
     "tarih",
     "ozet",
     "kaynak",
     "gazete_pdf",
     "kategori"
    ],
    "additionalProperties": false,
    "description": "Extra fields by type: officer (isim, sifat), capital (onceki, yeni), ownership (isim, pay_tutari, pay_orani), name/address (alan, deger), articles (madde, baslik), status (aciklama)."
   },
   "SonGazete": {
    "type": "object",
    "properties": {
     "ilan_id": {
      "type": "integer"
     },
     "tarih": {
      "type": "string",
      "format": "date"
     },
     "tur": {
      "type": "string"
     },
     "gazete_pdf": {
      "type": [
       "string",
       "null"
      ],
      "format": "uri"
     },
     "gazete_arsivde": {
      "type": "boolean"
     }
    },
    "required": [
     "ilan_id",
     "tarih",
     "tur",
     "gazete_pdf",
     "gazete_arsivde"
    ],
    "additionalProperties": false
   },
   "Ilan": {
    "type": "object",
    "properties": {
     "ilan_id": {
      "type": "integer"
     },
     "tarih": {
      "type": "string",
      "format": "date"
     },
     "tur": {
      "type": "string",
      "description": "Notice type."
     },
     "kategori": {
      "type": "string",
      "description": "Notice-type category (legacy `kategori=` filter).",
      "enum": [
       "kurulus",
       "konkordato",
       "birlesme",
       "sermaye",
       "ortaklik",
       "yonetim",
       "unvan_adres",
       "genel_kurul",
       "esas",
       "diger"
      ]
     },
     "kategori_ad": {
      "type": "string"
     },
     "sicil_no": {
      "type": [
       "string",
       "null"
      ]
     },
     "sayi": {
      "type": [
       "string",
       "null"
      ],
      "description": "Gazette issue number."
     },
     "sayfa": {
      "type": [
       "string",
       "null"
      ],
      "description": "Gazette page."
     },
     "baslik": {
      "type": [
       "string",
       "null"
      ],
      "description": "Plain-language title."
     },
     "aciklama": {
      "type": [
       "string",
       "null"
      ]
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     },
     "gazete_pdf": {
      "type": [
       "string",
       "null"
      ],
      "description": "Gazette PDF when archived.",
      "format": "uri"
     },
     "gazete_arsivde": {
      "type": "boolean"
     },
     "degisiklik_kategorisi": {
      "type": "string",
      "enum": [
       "durum",
       "adres",
       "ortaklik",
       "sermaye",
       "yetkililer",
       "unvan",
       "esas_sozlesme",
       "diger",
       "kapandi"
      ]
     }
    },
    "required": [
     "ilan_id",
     "tarih",
     "tur",
     "kategori",
     "kategori_ad",
     "sicil_no",
     "sayi",
     "sayfa",
     "baslik",
     "aciklama",
     "kaynak",
     "gazete_pdf",
     "gazete_arsivde",
     "degisiklik_kategorisi"
    ],
    "additionalProperties": false
   },
   "RaporOzeti": {
    "type": "object",
    "properties": {
     "rapor_id": {
      "type": "integer"
     },
     "durum": {
      "type": "string",
      "enum": [
       "hazir",
       "hata",
       "hazirlaniyor"
      ]
     },
     "talep": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "tamamlanma": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "dosyalar": {
      "type": "object",
      "description": "Type → download URL.",
      "additionalProperties": {
       "type": "string",
       "format": "uri"
      }
     },
     "bulgular": {
      "type": [
       "object",
       "null"
      ],
      "additionalProperties": true,
      "description": "Report findings (single profile only)."
     }
    },
    "required": [
     "rapor_id",
     "durum",
     "talep",
     "tamamlanma",
     "dosyalar",
     "bulgular"
    ],
    "additionalProperties": false
   },
   "VeriDurumuBolum": {
    "type": "object",
    "properties": {
     "durum": {
      "type": "string",
      "description": "tam (complete) · kismi (partial) · yok (looked, none) · hazirlaniyor (being prepared) · yayimlanmiyor (the source does not publish it).",
      "enum": [
       "tam",
       "kismi",
       "yok",
       "hazirlaniyor",
       "yayimlanmiyor"
      ]
     },
     "yontem": {
      "type": [
       "string",
       "null"
      ],
      "description": "ilandan (single notice) · ilandan_kuruldu (rebuilt from notices) · turetilmis (rule-based) · yapay_zeka (AI)",
      "enum": [
       "ilandan",
       "ilandan_kuruldu",
       "turetilmis",
       "yapay_zeka",
       null
      ]
     },
     "sinirlar": {
      "type": "array",
      "description": "Human-readable limitations.",
      "items": {
       "type": "string"
      }
     },
     "dayanak_ilan_sayisi": {
      "type": [
       "integer",
       "null"
      ],
      "description": "Number of distinct notices used."
     }
    },
    "required": [
     "durum",
     "yontem",
     "sinirlar",
     "dayanak_ilan_sayisi"
    ],
    "additionalProperties": false
   },
   "VeriDurumu": {
    "type": "object",
    "properties": {
     "kimlik": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "yetkililer": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "sermaye": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "ortaklik": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "unvan_adres": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "esas_sozlesme": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "ozet": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "ilanlar": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "raporlar": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "gercek_faydalanicilar": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "durum": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "uyum_sinyalleri": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     },
     "hukuki_bicim": {
      "$ref": "#/components/schemas/VeriDurumuBolum"
     }
    },
    "required": [
     "kimlik",
     "yetkililer",
     "sermaye",
     "ortaklik",
     "unvan_adres",
     "esas_sozlesme",
     "ilanlar",
     "gercek_faydalanicilar"
    ],
    "additionalProperties": {
     "$ref": "#/components/schemas/VeriDurumuBolum"
    },
    "description": "Completeness, method and limits per section. New sections are additive."
   },
   "StandartDurum": {
    "type": "object",
    "properties": {
     "kod": {
      "type": "string"
     },
     "ad": {
      "type": "string"
     },
     "ad_en": {
      "type": "string"
     },
     "uluslararasi": {
      "type": [
       "string",
       "null"
      ]
     },
     "renk": {
      "type": [
       "string",
       "null"
      ]
     },
     "tuzel_kisilik_suruyor": {
      "type": [
       "boolean",
       "null"
      ]
     },
     "yerel_durum": {
      "type": [
       "string",
       "null"
      ]
     },
     "kapanis_nedeni": {
      "type": [
       "object",
       "null"
      ]
     },
     "baslangic": {
      "type": [
       "string",
       "null"
      ]
     },
     "kapanis_tarihi": {
      "type": [
       "string",
       "null"
      ]
     },
     "kaynak": {
      "type": [
       "object",
       "null"
      ]
     },
     "dayanak": {
      "type": [
       "string",
       "null"
      ]
     },
     "aciklama": {
      "type": [
       "string",
       "null"
      ]
     },
     "aciklama_en": {
      "type": [
       "string",
       "null"
      ]
     },
     "gecmis": {
      "type": "array",
      "items": {
       "type": "object"
      }
     }
    },
    "required": [
     "kod"
    ],
    "additionalProperties": true,
    "description": "Status standardised from notice wording by fixed rules."
   },
   "UyumSinyali": {
    "type": "object",
    "properties": {
     "tur": {
      "type": "string"
     },
     "ad": {
      "type": "string"
     },
     "ad_en": {
      "type": "string"
     },
     "aktif": {
      "type": [
       "boolean",
       "null"
      ]
     },
     "aciklama": {
      "type": "string"
     },
     "aciklama_en": {
      "type": "string"
     },
     "kaynak": {
      "type": [
       "object",
       "null"
      ]
     },
     "tarih": {
      "type": [
       "string",
       "null"
      ]
     },
     "tarih_tr": {
      "type": [
       "string",
       "null"
      ]
     },
     "dayanak": {
      "type": [
       "string",
       "null"
      ]
     }
    },
    "required": [
     "tur",
     "aktif"
    ],
    "additionalProperties": true
   },
   "Profil": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "tum_gazeteler_zip": {
      "type": "string",
      "description": "All gazette PDFs (ZIP).",
      "format": "uri"
     },
     "profil_hazir": {
      "type": "boolean",
      "description": "Whether the profile exists. While false, profile sections are null."
     },
     "guncelleme": {
      "type": [
       "string",
       "null"
      ],
      "description": "When the profile was generated.",
      "format": "date-time"
     },
     "ozet": {
      "type": [
       "string",
       "null"
      ],
      "description": "Neutral AI-written summary."
     },
     "kimlik": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kimlik"
       },
       {
        "type": "null"
       }
      ]
     },
     "yetkililer": {
      "type": [
       "array",
       "null"
      ],
      "items": {
       "$ref": "#/components/schemas/Yetkili"
      }
     },
     "sermaye": {
      "type": [
       "array",
       "null"
      ],
      "items": {
       "$ref": "#/components/schemas/SermayeKaydi"
      }
     },
     "ortaklik": {
      "type": [
       "array",
       "null"
      ],
      "items": {
       "$ref": "#/components/schemas/OrtaklikKaydi"
      }
     },
     "unvan_adres": {
      "type": [
       "array",
       "null"
      ],
      "items": {
       "$ref": "#/components/schemas/UnvanAdresKaydi"
      }
     },
     "esas_sozlesme": {
      "type": [
       "array",
       "null"
      ],
      "items": {
       "$ref": "#/components/schemas/EsasSozlesmeMaddesi"
      }
     },
     "degisiklikler": {
      "type": [
       "array",
       "null"
      ],
      "description": "All changes in one chronological feed (newest first).",
      "items": {
       "$ref": "#/components/schemas/Degisiklik"
      }
     },
     "son_gazete": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/SonGazete"
       },
       {
        "type": "null"
       }
      ]
     },
     "ilanlar": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Ilan"
      }
     },
     "raporlar": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/RaporOzeti"
      }
     },
     "aciklama_degisiklikler": {
      "type": "string"
     },
     "aciklama": {
      "type": "string"
     },
     "aciklama_veri_durumu": {
      "type": "string"
     },
     "veri_durumu": {
      "$ref": "#/components/schemas/VeriDurumu"
     },
     "gercek_faydalanicilar": {
      "type": "string",
      "description": "Beneficial ownership is not published in a public register in Türkiye; the profile calculates it from the shareholdings in the notices.",
      "enum": [
       "yayimlanmiyor"
      ]
     },
     "durum": {
      "$ref": "#/components/schemas/StandartDurum"
     },
     "uyum_sinyalleri": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/UyumSinyali"
      }
     }
    },
    "required": [
     "sirket",
     "tum_gazeteler_zip",
     "profil_hazir",
     "guncelleme",
     "ozet",
     "kimlik",
     "yetkililer",
     "sermaye",
     "ortaklik",
     "unvan_adres",
     "esas_sozlesme",
     "degisiklikler",
     "son_gazete",
     "ilanlar",
     "raporlar",
     "aciklama_degisiklikler",
     "aciklama",
     "veri_durumu",
     "gercek_faydalanicilar",
     "aciklama_veri_durumu"
    ],
    "additionalProperties": false
   },
   "SirketSatiri": {
    "type": "object",
    "properties": {
     "id": {
      "type": [
       "integer",
       "string"
      ],
      "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
     },
     "unvan": {
      "type": [
       "string",
       "null"
      ]
     },
     "mudurluk": {
      "type": [
       "string",
       "null"
      ]
     },
     "sicil_no": {
      "type": [
       "string",
       "null"
      ]
     },
     "ilan_sayisi": {
      "type": "integer"
     },
     "profil": {
      "type": "string",
      "format": "uri"
     }
    },
    "required": [
     "id",
     "unvan",
     "mudurluk",
     "sicil_no",
     "ilan_sayisi",
     "profil"
    ],
    "additionalProperties": false
   },
   "SirketListesi": {
    "type": "object",
    "properties": {
     "adet": {
      "type": "integer",
      "description": "Total records."
     },
     "sayfa": {
      "type": "integer"
     },
     "sayfa_adedi": {
      "type": "integer",
      "description": "Records per page."
     },
     "sonraki_sayfa": {
      "type": [
       "integer",
       "null"
      ],
      "description": "Next page; null on the last page."
     },
     "sirketler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/SirketSatiri"
      }
     }
    },
    "required": [
     "adet",
     "sayfa",
     "sayfa_adedi",
     "sonraki_sayfa",
     "sirketler"
    ],
    "additionalProperties": false
   },
   "EklemeSonucu": {
    "type": "object",
    "properties": {
     "durum": {
      "type": "string",
      "description": "eklendi (201) or zaten_var (200, no allowance used).",
      "enum": [
       "eklendi",
       "zaten_var"
      ]
     },
     "sirket_id": {
      "type": [
       "integer",
       "string"
      ],
      "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
     },
     "kayit_id": {
      "type": [
       "integer",
       "null"
      ]
     },
     "unvan": {
      "type": [
       "string",
       "null"
      ]
     },
     "mudurluk": {
      "type": "string"
     },
     "sicil_no": {
      "type": "string"
     },
     "aciklama": {
      "type": "string"
     },
     "profil": {
      "type": "string",
      "format": "uri"
     },
     "durum_adresi": {
      "type": "string",
      "description": "Status polling URL.",
      "format": "uri"
     }
    },
    "required": [
     "durum",
     "sirket_id",
     "kayit_id",
     "mudurluk",
     "sicil_no",
     "profil",
     "durum_adresi"
    ],
    "additionalProperties": false
   },
   "HazirlikDurumu": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "asama": {
      "type": "string",
      "description": "ilanlar-cekiliyor → gazeteler-indiriliyor → profil-hazirlaniyor → hazir; sube for branches.",
      "enum": [
       "ilanlar-cekiliyor",
       "gazeteler-indiriliyor",
       "profil-hazirlaniyor",
       "hazir",
       "sube"
      ]
     },
     "asama_adi": {
      "type": "string"
     },
     "yuzde": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
     },
     "ilan_sayisi": {
      "type": "integer"
     },
     "arsivdeki_gazete": {
      "type": "integer"
     },
     "profil_hazir": {
      "type": "boolean"
     },
     "guncelleme": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "profil": {
      "type": "string",
      "format": "uri"
     }
    },
    "required": [
     "sirket",
     "asama",
     "asama_adi",
     "yuzde",
     "ilan_sayisi",
     "arsivdeki_gazete",
     "profil_hazir",
     "guncelleme",
     "profil"
    ],
    "additionalProperties": false
   },
   "DegisiklikListesi": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "son_gazete": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/SonGazete"
       },
       {
        "type": "null"
       }
      ]
     },
     "adet": {
      "type": "integer"
     },
     "sayfa": {
      "type": "integer"
     },
     "sayfa_adedi": {
      "type": "integer"
     },
     "sonraki_sayfa": {
      "type": [
       "integer",
       "null"
      ]
     },
     "turler": {
      "type": "array",
      "description": "Types seen for this company.",
      "items": {
       "type": "string"
      }
     },
     "kategoriler": {
      "type": "array",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "profil_hazir": {
      "type": "boolean"
     },
     "degisiklikler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Degisiklik"
      }
     }
    },
    "required": [
     "sirket",
     "son_gazete",
     "adet",
     "sayfa",
     "sayfa_adedi",
     "sonraki_sayfa",
     "turler",
     "kategoriler",
     "profil_hazir",
     "degisiklikler"
    ],
    "additionalProperties": false
   },
   "GunlukDegisiklik": {
    "type": "object",
    "properties": {
     "tur": {
      "type": "string",
      "description": "Change type.",
      "enum": [
       "yetkili-atama",
       "yetkili-ayrilma",
       "sermaye",
       "ortaklik",
       "unvan-adres",
       "esas-sozlesme",
       "durum"
      ]
     },
     "tarih": {
      "type": [
       "string",
       "null"
      ],
      "description": "Date of the change.",
      "format": "date"
     },
     "ozet": {
      "type": "string",
      "description": "One-line summary."
     },
     "kaynak": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Kaynak"
       },
       {
        "type": "null"
       }
      ]
     },
     "gazete_pdf": {
      "type": [
       "string",
       "null"
      ],
      "description": "PDF of the source gazette.",
      "format": "uri"
     },
     "kategori": {
      "type": "string",
      "description": "Fixed change category.",
      "enum": [
       "durum",
       "adres",
       "ortaklik",
       "sermaye",
       "yetkililer",
       "unvan",
       "esas_sozlesme",
       "diger",
       "kapandi"
      ]
     },
     "isim": {
      "type": [
       "string",
       "null"
      ]
     },
     "sifat": {
      "type": [
       "string",
       "null"
      ]
     },
     "onceki": {
      "type": [
       "string",
       "null"
      ]
     },
     "yeni": {
      "type": [
       "string",
       "null"
      ]
     },
     "pay_tutari": {
      "type": [
       "string",
       "null"
      ]
     },
     "pay_orani": {
      "type": [
       "string",
       "null"
      ]
     },
     "alan": {
      "type": [
       "string",
       "null"
      ]
     },
     "deger": {
      "type": [
       "string",
       "null"
      ]
     },
     "madde": {
      "type": [
       "string",
       "null"
      ]
     },
     "baslik": {
      "type": [
       "string",
       "null"
      ]
     },
     "aciklama": {
      "type": [
       "string",
       "null"
      ]
     },
     "sirket": {
      "type": "object",
      "properties": {
       "id": {
        "type": [
         "integer",
         "string"
        ],
        "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
       },
       "unvan": {
        "type": [
         "string",
         "null"
        ]
       },
       "sicil_no": {
        "type": [
         "string",
         "null"
        ]
       },
       "mudurluk": {
        "type": [
         "string",
         "null"
        ]
       }
      },
      "required": [
       "id",
       "unvan",
       "sicil_no",
       "mudurluk"
      ],
      "additionalProperties": false
     }
    },
    "required": [
     "tur",
     "tarih",
     "ozet",
     "kaynak",
     "gazete_pdf",
     "kategori",
     "sirket"
    ],
    "additionalProperties": false,
    "description": "Change row + which company."
   },
   "GunlukDegisiklikListesi": {
    "type": "object",
    "properties": {
     "gun": {
      "type": "integer"
     },
     "adet": {
      "type": "integer"
     },
     "sayfa": {
      "type": "integer"
     },
     "sayfa_adedi": {
      "type": "integer"
     },
     "sonraki_sayfa": {
      "type": [
       "integer",
       "null"
      ]
     },
     "degisiklikler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/GunlukDegisiklik"
      }
     }
    },
    "required": [
     "gun",
     "adet",
     "sayfa",
     "sayfa_adedi",
     "sonraki_sayfa",
     "degisiklikler"
    ],
    "additionalProperties": false
   },
   "YetkiliListesi": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "tarih": {
      "type": "string",
      "description": "Requested date or \"güncel\" (current)."
     },
     "adet": {
      "type": "integer"
     },
     "profil_hazir": {
      "type": "boolean"
     },
     "yetkililer": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Yetkili"
      }
     }
    },
    "required": [
     "sirket",
     "tarih",
     "adet",
     "profil_hazir",
     "yetkililer"
    ],
    "additionalProperties": false
   },
   "GorevBitisi": {
    "type": "object",
    "properties": {
     "grup_id": {
      "type": [
       "integer",
       "string"
      ],
      "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
     },
     "unvan": {
      "type": [
       "string",
       "null"
      ]
     },
     "isim": {
      "type": [
       "string",
       "null"
      ]
     },
     "sifat": {
      "type": "string"
     },
     "temsil": {
      "type": "string"
     },
     "gorev_bitis": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "kalan": {
      "type": "integer",
      "description": "Days left; negative when expired."
     },
     "gorev_suresi": {
      "type": "string"
     },
     "dayanak": {
      "type": "string"
     },
     "durum": {
      "type": "string",
      "enum": [
       "yaklasiyor",
       "doldu"
      ]
     }
    },
    "required": [
     "grup_id",
     "unvan",
     "isim",
     "sifat",
     "temsil",
     "gorev_bitis",
     "kalan",
     "gorev_suresi",
     "dayanak",
     "durum"
    ],
    "additionalProperties": false
   },
   "GorevBitisleri": {
    "type": "object",
    "properties": {
     "ufuk_gun": {
      "type": "integer"
     },
     "adet": {
      "type": "integer"
     },
     "gorevler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/GorevBitisi"
      }
     }
    },
    "required": [
     "ufuk_gun",
     "adet",
     "gorevler"
    ],
    "additionalProperties": false
   },
   "IlanListesi": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "adet": {
      "type": "integer"
     },
     "ilanlar": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Ilan"
      }
     }
    },
    "required": [
     "sirket",
     "adet",
     "ilanlar"
    ],
    "additionalProperties": false
   },
   "RaporSatiri": {
    "type": "object",
    "properties": {
     "rapor_id": {
      "type": "integer"
     },
     "durum": {
      "type": "string",
      "enum": [
       "hazir",
       "hata",
       "hazirlaniyor"
      ]
     },
     "talep": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "tamamlanma": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "dosyalar": {
      "type": "object",
      "additionalProperties": {
       "type": "string",
       "format": "uri"
      }
     },
     "sirket": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "id": {
          "type": "integer"
         },
         "unvan": {
          "type": [
           "string",
           "null"
          ]
         },
         "sicil_no": {
          "type": [
           "string",
           "null"
          ]
         }
        },
        "required": [
         "id",
         "unvan",
         "sicil_no"
        ],
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ]
     },
     "profil": {
      "type": [
       "string",
       "null"
      ],
      "format": "uri"
     }
    },
    "required": [
     "rapor_id",
     "durum",
     "talep",
     "tamamlanma",
     "dosyalar",
     "sirket",
     "profil"
    ],
    "additionalProperties": false
   },
   "RaporListesi": {
    "type": "object",
    "properties": {
     "adet": {
      "type": "integer"
     },
     "sayfa": {
      "type": "integer"
     },
     "sayfa_adedi": {
      "type": "integer"
     },
     "sonraki_sayfa": {
      "type": [
       "integer",
       "null"
      ]
     },
     "raporlar": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/RaporSatiri"
      }
     }
    },
    "required": [
     "adet",
     "sayfa",
     "sayfa_adedi",
     "sonraki_sayfa",
     "raporlar"
    ],
    "additionalProperties": false
   },
   "GazeteKaydi": {
    "type": "object",
    "properties": {
     "ilan_id": {
      "type": "integer"
     },
     "tarih": {
      "type": "string",
      "format": "date"
     },
     "tur": {
      "type": "string"
     },
     "sirket": {
      "type": "object",
      "properties": {
       "id": {
        "type": [
         "integer",
         "string"
        ],
        "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
       },
       "unvan": {
        "type": [
         "string",
         "null"
        ]
       },
       "sicil_no": {
        "type": [
         "string",
         "null"
        ]
       }
      },
      "required": [
       "id",
       "unvan",
       "sicil_no"
      ],
      "additionalProperties": false
     },
     "gazete": {
      "type": "object",
      "properties": {
       "guid": {
        "type": "string"
       },
       "boyut_bayt": {
        "type": [
         "integer",
         "null"
        ]
       },
       "sayfa_sayisi": {
        "type": [
         "integer",
         "null"
        ]
       },
       "ocr_var": {
        "type": "boolean"
       },
       "indirme": {
        "type": [
         "string",
         "null"
        ],
        "format": "date-time"
       }
      },
      "required": [
       "guid",
       "boyut_bayt",
       "sayfa_sayisi",
       "ocr_var",
       "indirme"
      ],
      "additionalProperties": false
     },
     "pdf": {
      "type": "string",
      "format": "uri"
     }
    },
    "required": [
     "ilan_id",
     "tarih",
     "tur",
     "sirket",
     "gazete",
     "pdf"
    ],
    "additionalProperties": false
   },
   "GazeteListesi": {
    "type": "object",
    "properties": {
     "toplam": {
      "type": "integer"
     },
     "sayfa": {
      "type": "integer"
     },
     "adet": {
      "type": "integer",
      "description": "Records per page."
     },
     "gazeteler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/GazeteKaydi"
      }
     }
    },
    "required": [
     "toplam",
     "sayfa",
     "adet",
     "gazeteler"
    ],
    "additionalProperties": false
   },
   "KapYaniti": {
    "type": "object",
    "properties": {
     "sirket": {
      "type": "object",
      "properties": {
       "id": {
        "type": "integer"
       },
       "unvan": {
        "type": [
         "string",
         "null"
        ]
       }
      },
      "required": [
       "id",
       "unvan"
      ],
      "additionalProperties": false
     },
     "kap_sirket": {
      "type": "object",
      "properties": {
       "kap_id": {
        "type": [
         "integer",
         "string"
        ]
       },
       "unvan": {
        "type": [
         "string",
         "null"
        ]
       },
       "borsa_kodu": {
        "type": [
         "string",
         "null"
        ]
       },
       "uye_tipi": {
        "type": [
         "string",
         "null"
        ]
       }
      },
      "required": [
       "kap_id",
       "unvan",
       "borsa_kodu",
       "uye_tipi"
      ],
      "additionalProperties": false
     },
     "fonlar": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "fon_id": {
         "type": [
          "integer",
          "string"
         ]
        },
        "kod": {
         "type": [
          "string",
          "null"
         ]
        },
        "ad": {
         "type": [
          "string",
          "null"
         ]
        },
        "tur": {
         "type": [
          "string",
          "null"
         ]
        },
        "sinif": {
         "type": [
          "string",
          "null"
         ]
        },
        "durum": {
         "type": [
          "string",
          "null"
         ]
        }
       },
       "required": [
        "fon_id",
        "kod",
        "ad",
        "tur",
        "sinif",
        "durum"
       ],
       "additionalProperties": false
      }
     },
     "bildirimler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "index": {
         "type": [
          "integer",
          "string"
         ]
        },
        "zaman": {
         "type": [
          "string",
          "null"
         ],
         "format": "date-time"
        },
        "tip": {
         "type": [
          "string",
          "null"
         ]
        },
        "sinif": {
         "type": [
          "string",
          "null"
         ]
        },
        "konu": {
         "type": [
          "string",
          "null"
         ]
        },
        "ozet": {
         "type": [
          "string",
          "null"
         ]
        },
        "fon_kod": {
         "type": [
          "string",
          "null"
         ]
        },
        "link": {
         "type": [
          "string",
          "null"
         ]
        },
        "ekler": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "ad": {
            "type": [
             "string",
             "null"
            ]
           },
           "indir": {
            "type": "string",
            "format": "uri"
           }
          },
          "required": [
           "ad",
           "indir"
          ],
          "additionalProperties": false
         }
        },
        "veri": {
         "description": "Structured data of the disclosure, if any."
        }
       },
       "required": [
        "index",
        "zaman",
        "tip",
        "sinif",
        "konu",
        "ozet",
        "fon_kod",
        "link",
        "ekler",
        "veri"
       ],
       "additionalProperties": false
      }
     },
     "kaynak": {
      "type": "string"
     }
    },
    "required": [
     "sirket",
     "kap_sirket",
     "fonlar",
     "bildirimler",
     "kaynak"
    ],
    "additionalProperties": false
   },
   "YaptirimIsabeti": {
    "type": "object",
    "properties": {
     "ad": {
      "type": "string",
      "description": "Name on the list."
     },
     "guven": {
      "type": "string",
      "description": "Matching is exact-name only (ignoring order, accents and case): tam.",
      "enum": [
       "tam",
       "kismi",
       "benzer"
      ]
     },
     "puan": {
      "type": [
       "number",
       "integer",
       "null"
      ]
     },
     "oncelik": {
      "type": [
       "integer",
       "string",
       "null"
      ]
     },
     "liste": {
      "type": "string",
      "description": "List code (BM, AB, MASAK…)."
     },
     "liste_ad": {
      "type": [
       "string",
       "null"
      ]
     },
     "liste_kaydi": {
      "type": [
       "string",
       "null"
      ]
     },
     "program": {
      "type": [
       "string",
       "null"
      ]
     },
     "ayrinti": {
      "type": [
       "string",
       "null"
      ]
     },
     "dis_id": {
      "type": [
       "string",
       "null"
      ]
     }
    },
    "required": [
     "ad",
     "guven",
     "puan",
     "oncelik",
     "liste",
     "liste_ad",
     "liste_kaydi",
     "program",
     "ayrinti",
     "dis_id"
    ],
    "additionalProperties": false
   },
   "YaptirimTaramasi": {
    "type": "object",
    "properties": {
     "taranan": {
      "type": "integer"
     },
     "liste_tarihi": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "listeler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "kod": {
         "type": "string"
        },
        "ad": {
         "type": "string"
        },
        "kayit": {
         "type": "integer"
        },
        "guncelleme": {
         "type": [
          "string",
          "null"
         ],
         "format": "date-time"
        },
        "kaynak_tarihi": {
         "type": [
          "string",
          "null"
         ],
         "format": "date"
        },
        "indirme": {
         "type": [
          "string",
          "null"
         ],
         "format": "date-time"
        },
        "bayat": {
         "type": "boolean"
        },
        "url": {
         "type": "string"
        },
        "hata": {
         "type": [
          "string",
          "null"
         ]
        }
       },
       "required": [
        "kod",
        "ad",
        "kayit",
        "guncelleme",
        "kaynak_tarihi",
        "indirme",
        "bayat",
        "url",
        "hata"
       ],
       "additionalProperties": false
      }
     },
     "tarama_no": {
      "type": [
       "integer",
       "null"
      ]
     },
     "isabetler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/YaptirimIsabeti"
      }
     },
     "not": {
      "type": "string"
     }
    },
    "required": [
     "taranan",
     "liste_tarihi",
     "listeler",
     "tarama_no",
     "isabetler",
     "not"
    ],
    "additionalProperties": false
   },
   "Teslim": {
    "type": "object",
    "properties": {
     "teslim_id": {
      "type": "string",
      "description": "Same across retries (de-duplication)."
     },
     "olay": {
      "type": "string",
      "enum": [
       "sirket.degisiklik",
       "test"
      ]
     },
     "test": {
      "type": "boolean"
     },
     "kategoriler": {
      "type": "array",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "durum": {
      "type": "string",
      "enum": [
       "bekliyor",
       "basarili",
       "hata",
       "vazgecildi"
      ]
     },
     "deneme_sayisi": {
      "type": "integer"
     },
     "http_kodu": {
      "type": [
       "integer",
       "null"
      ]
     },
     "hata": {
      "type": [
       "string",
       "null"
      ]
     },
     "olusturma": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "son_deneme": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     }
    },
    "required": [
     "teslim_id",
     "olay",
     "test",
     "kategoriler",
     "durum",
     "deneme_sayisi",
     "http_kodu",
     "hata",
     "olusturma",
     "son_deneme"
    ],
    "additionalProperties": false
   },
   "Webhook": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "aktif": {
      "type": "boolean"
     },
     "kategoriler": {
      "type": "array",
      "description": "Empty = all categories.",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "tum_kategoriler": {
      "type": "boolean"
     },
     "olusturma": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "son_gonderim": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "son_durum": {
      "type": [
       "string",
       "null"
      ]
     },
     "ardisik_hata": {
      "type": "integer",
      "description": "Consecutive failures; paused at 20."
     },
     "son_teslimler": {
      "type": "array",
      "description": "Only in webhook detail (last 20).",
      "items": {
       "$ref": "#/components/schemas/Teslim"
      }
     }
    },
    "required": [
     "id",
     "url",
     "aktif",
     "kategoriler",
     "tum_kategoriler",
     "olusturma",
     "son_gonderim",
     "son_durum",
     "ardisik_hata"
    ],
    "additionalProperties": false
   },
   "YeniWebhook": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "aktif": {
      "type": "boolean"
     },
     "kategoriler": {
      "type": "array",
      "description": "Empty = all categories.",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "tum_kategoriler": {
      "type": "boolean"
     },
     "olusturma": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "son_gonderim": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "son_durum": {
      "type": [
       "string",
       "null"
      ]
     },
     "ardisik_hata": {
      "type": "integer",
      "description": "Consecutive failures; paused at 20."
     },
     "son_teslimler": {
      "type": "array",
      "description": "Only in webhook detail (last 20).",
      "items": {
       "$ref": "#/components/schemas/Teslim"
      }
     },
     "gizli": {
      "type": "string",
      "description": "Signing secret (whsec_…): shown ONLY in this response."
     },
     "aciklama": {
      "type": "string"
     }
    },
    "required": [
     "id",
     "url",
     "aktif",
     "kategoriler",
     "tum_kategoriler",
     "olusturma",
     "son_gonderim",
     "son_durum",
     "ardisik_hata",
     "gizli",
     "aciklama"
    ],
    "additionalProperties": false
   },
   "WebhookListesi": {
    "type": "object",
    "properties": {
     "adet": {
      "type": "integer"
     },
     "kategoriler": {
      "type": "array",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "webhooklar": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Webhook"
      }
     }
    },
    "required": [
     "adet",
     "kategoriler",
     "webhooklar"
    ],
    "additionalProperties": false
   },
   "WebhookSilindi": {
    "type": "object",
    "properties": {
     "silindi": {
      "type": "boolean"
     },
     "id": {
      "type": "integer"
     }
    },
    "required": [
     "silindi",
     "id"
    ],
    "additionalProperties": false
   },
   "WebhookTestSonucu": {
    "type": "object",
    "properties": {
     "teslim": {
      "$ref": "#/components/schemas/Teslim"
     }
    },
    "required": [
     "teslim"
    ],
    "additionalProperties": false
   },
   "WebhookYuku": {
    "type": "object",
    "properties": {
     "olay": {
      "type": "string",
      "enum": [
       "sirket.degisiklik",
       "test"
      ]
     },
     "surum": {
      "type": "integer"
     },
     "teslim_id": {
      "type": "string"
     },
     "test": {
      "type": "boolean"
     },
     "zaman": {
      "type": "string",
      "format": "date-time"
     },
     "sirket": {
      "type": "object",
      "properties": {
       "id": {
        "type": [
         "integer",
         "string"
        ],
        "description": "Company id: numeric with a live key (e.g. 1234); a DENEME-… string with a sandbox key."
       },
       "unvan": {
        "type": [
         "string",
         "null"
        ]
       },
       "mudurluk": {
        "type": [
         "string",
         "null"
        ]
       },
       "sicil_no": {
        "type": [
         "string",
         "null"
        ]
       },
       "profil": {
        "type": "string",
        "format": "uri"
       },
       "degisiklikler": {
        "type": "string",
        "format": "uri"
       }
      },
      "required": [
       "id",
       "unvan",
       "mudurluk",
       "sicil_no",
       "profil",
       "degisiklikler"
      ],
      "additionalProperties": false
     },
     "kategoriler": {
      "type": "array",
      "items": {
       "type": "string",
       "enum": [
        "durum",
        "adres",
        "ortaklik",
        "sermaye",
        "yetkililer",
        "unvan",
        "esas_sozlesme",
        "diger",
        "kapandi"
       ]
      }
     },
     "degisiklikler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "kategori": {
         "type": "string",
         "enum": [
          "durum",
          "adres",
          "ortaklik",
          "sermaye",
          "yetkililer",
          "unvan",
          "esas_sozlesme",
          "diger",
          "kapandi"
         ]
        },
        "kategori_ad": {
         "type": [
          "string",
          "null"
         ]
        },
        "tur": {
         "type": "string"
        },
        "tarih": {
         "type": [
          "string",
          "null"
         ],
         "format": "date"
        },
        "ozet": {
         "type": "string"
        },
        "ilan": {
         "anyOf": [
          {
           "type": "object",
           "properties": {
            "ilan_id": {
             "type": "integer"
            },
            "ilan_tarihi": {
             "type": [
              "string",
              "null"
             ],
             "format": "date"
            },
            "ilan_turu": {
             "type": [
              "string",
              "null"
             ]
            },
            "alinti": {
             "type": [
              "string",
              "null"
             ]
            }
           },
           "required": [
            "ilan_id",
            "ilan_tarihi",
            "ilan_turu",
            "alinti"
           ],
           "additionalProperties": false
          },
          {
           "type": "null"
          }
         ]
        },
        "gazete_pdf": {
         "type": [
          "string",
          "null"
         ],
         "format": "uri"
        }
       },
       "required": [
        "kategori",
        "kategori_ad",
        "tur",
        "tarih",
        "ozet",
        "ilan",
        "gazete_pdf"
       ],
       "additionalProperties": false
      }
     }
    },
    "required": [
     "olay",
     "surum",
     "teslim_id",
     "test",
     "zaman",
     "sirket",
     "kategoriler",
     "degisiklikler"
    ],
    "additionalProperties": false,
    "description": "Webhook body: the notice itself (company, category, date, type, summary, gazette PDF)."
   },
   "KatalogUlke": {
    "type": "object",
    "properties": {
     "kod": {
      "type": "string"
     },
     "ad": {
      "type": "string"
     },
     "bayrak": {
      "type": "string"
     },
     "yerel_ad": {
      "type": "string"
     },
     "bolge": {
      "type": "string"
     },
     "bolge_ad": {
      "type": "string"
     },
     "kademe": {
      "type": "string"
     },
     "kademe_ad": {
      "type": "string"
     },
     "hedef_kademe": {
      "type": [
       "string",
       "null"
      ]
     },
     "beta": {
      "type": "boolean"
     },
     "bekleyen": {
      "type": "boolean"
     },
     "kaynak": {
      "type": "string",
      "description": "Generic name of the source."
     },
     "kimlikler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "ad": {
         "type": "string"
        },
        "bicim": {
         "type": "string"
        },
        "ornek": {
         "type": "string"
        },
        "kontrol": {
         "type": "string"
        },
        "aranabilir": {
         "type": "boolean"
        },
        "birincil": {
         "type": "boolean"
        }
       },
       "required": [
        "ad",
        "bicim",
        "ornek",
        "kontrol",
        "aranabilir",
        "birincil"
       ],
       "additionalProperties": false
      }
     },
     "veri": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "properties": {
        "durum": {
         "type": "string",
         "enum": [
          "var",
          "kismi",
          "ilan",
          "istek",
          "yok"
         ]
        },
        "etiket": {
         "type": "string"
        },
        "not": {
         "type": "string"
        }
       },
       "required": [
        "durum",
        "etiket",
        "not"
       ],
       "additionalProperties": false
      }
     },
     "belgeler": {
      "type": "array",
      "items": {
       "type": "object",
       "additionalProperties": true
      }
     },
     "yenileme": {
      "type": "object",
      "properties": {
       "sinif": {
        "type": "string"
       },
       "ad": {
        "type": "string"
       }
      },
      "required": [
       "sinif",
       "ad"
      ],
      "additionalProperties": false
     },
     "izleme": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "uyum_isaretleri": {
      "type": "array",
      "items": {
       "type": "object",
       "additionalProperties": true
      }
     },
     "uyum_ilkesi": {
      "type": "string"
     },
     "yanit": {
      "type": "object",
      "properties": {
       "sinif": {
        "type": "string"
       },
       "ad": {
        "type": "string"
       }
      },
      "required": [
       "sinif",
       "ad"
      ],
      "additionalProperties": false
     },
     "notlar": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "surum": {
      "type": "string"
     }
    },
    "required": [
     "kod",
     "ad",
     "kademe",
     "kimlikler",
     "veri",
     "belgeler",
     "yenileme",
     "izleme",
     "yanit",
     "notlar"
    ],
    "additionalProperties": true
   },
   "Katalog": {
    "type": "object",
    "properties": {
     "surum": {
      "type": "string"
     },
     "dil": {
      "type": "string",
      "enum": [
       "tr",
       "en"
      ]
     },
     "durumlar": {
      "type": "object",
      "additionalProperties": {
       "type": "string"
      }
     },
     "veri_noktalari": {
      "type": "object",
      "additionalProperties": {
       "type": "string"
      }
     },
     "yenileme_siniflari": {
      "type": "object",
      "additionalProperties": {
       "type": "string"
      }
     },
     "yanit_siniflari": {
      "type": "object",
      "additionalProperties": {
       "type": "string"
      }
     },
     "uyelik": {
      "type": "object",
      "properties": {
       "dahil": {
        "type": "string"
       },
       "istek": {
        "type": "string"
       }
      },
      "required": [
       "dahil",
       "istek"
      ],
      "additionalProperties": false
     },
     "ulke_sayisi": {
      "type": "integer"
     },
     "ulkeler": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/KatalogUlke"
      }
     }
    },
    "required": [
     "surum",
     "dil",
     "durumlar",
     "veri_noktalari",
     "yenileme_siniflari",
     "yanit_siniflari",
     "uyelik",
     "ulke_sayisi",
     "ulkeler"
    ],
    "additionalProperties": true
   },
   "BasitHata": {
    "type": "object",
    "properties": {
     "hata": {
      "type": "string"
     },
     "kod": {
      "type": "string"
     }
    },
    "required": [
     "hata"
    ],
    "additionalProperties": false
   },
   "HizmetDurumu": {
    "type": "object",
    "properties": {
     "surum": {
      "type": "string"
     },
     "dil": {
      "type": "string"
     },
     "gun_sayisi": {
      "type": "integer"
     },
     "baslangic": {
      "type": "string",
      "format": "date"
     },
     "bitis": {
      "type": "string",
      "format": "date"
     },
     "durumlar": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "properties": {
        "ad": {
         "type": "string"
        },
        "aciklama": {
         "type": "string"
        }
       },
       "required": [
        "ad",
        "aciklama"
       ],
       "additionalProperties": false
      }
     },
     "genel": {
      "type": "string",
      "enum": [
       "calisiyor",
       "yavas",
       "kesinti",
       "bilinmiyor"
      ]
     },
     "gruplar": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "anahtar": {
         "type": "string"
        },
        "ad": {
         "type": "string"
        },
        "bilesenler": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "anahtar": {
            "type": "string"
           },
           "ad": {
            "type": "string"
           },
           "aciklama": {
            "type": [
             "string",
             "null"
            ]
           },
           "ulke": {
            "type": [
             "string",
             "null"
            ]
           },
           "durum": {
            "type": "string",
            "enum": [
             "calisiyor",
             "yavas",
             "kesinti",
             "bilinmiyor"
            ]
           },
           "durum_gunu": {
            "type": "string",
            "enum": [
             "bugun",
             "dun"
            ]
           },
           "olculen_gun": {
            "type": "integer"
           },
           "sorunsuz_yuzde": {
            "type": [
             "number",
             "null"
            ]
           },
           "gunler": {
            "type": "array",
            "items": {
             "type": "object",
             "properties": {
              "gun": {
               "type": "string",
               "format": "date"
              },
              "durum": {
               "type": "string"
              },
              "not": {
               "type": "string"
              }
             },
             "required": [
              "gun",
              "durum"
             ],
             "additionalProperties": false
            }
           }
          },
          "required": [
           "anahtar",
           "ad",
           "aciklama",
           "ulke",
           "durum",
           "durum_gunu",
           "olculen_gun",
           "sorunsuz_yuzde",
           "gunler"
          ],
          "additionalProperties": false
         }
        }
       },
       "required": [
        "anahtar",
        "ad",
        "bilesenler"
       ],
       "additionalProperties": false
      }
     },
     "notlar": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "gun": {
         "type": "string",
         "format": "date"
        },
        "bilesen": {
         "type": "string"
        },
        "durum": {
         "type": "string"
        },
        "not": {
         "type": "string"
        }
       },
       "required": [
        "gun",
        "bilesen",
        "durum",
        "not"
       ],
       "additionalProperties": false
      }
     }
    },
    "required": [
     "surum",
     "dil",
     "gun_sayisi",
     "baslangic",
     "bitis",
     "durumlar",
     "genel",
     "gruplar",
     "notlar"
    ],
    "additionalProperties": false
   },
   "EskiSirketListesi": {
    "type": "object",
    "properties": {
     "count": {
      "type": "integer"
     },
     "companies": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "group_id": {
         "type": "integer"
        },
        "unvan": {
         "type": [
          "string",
          "null"
         ]
        },
        "mudurluk": {
         "type": [
          "string",
          "null"
         ]
        },
        "sicil_no": {
         "type": [
          "string",
          "null"
         ]
        },
        "profil_hazir": {
         "type": "boolean"
        }
       },
       "required": [
        "group_id",
        "unvan",
        "mudurluk",
        "sicil_no",
        "profil_hazir"
       ],
       "additionalProperties": false
      }
     }
    },
    "required": [
     "count",
     "companies"
    ],
    "additionalProperties": false
   },
   "EskiProfil": {
    "type": "object",
    "additionalProperties": true,
    "required": [
     "unvan",
     "mudurluk",
     "sicil_no",
     "guncelleme",
     "ilan_sayisi",
     "profil"
    ]
   },
   "EskiHataEn": {
    "type": "object",
    "properties": {
     "error": {
      "type": "string"
     },
     "detail": {
      "type": "string"
     }
    },
    "required": [
     "error"
    ],
    "additionalProperties": false
   },
   "Muhur": {
    "type": "object",
    "properties": {
     "kod": {
      "type": "string",
      "description": "DOGRULANDI: core sections complete and every fact tied to a verified quote · KISMI: profile ready but a condition is not met (see reasons) · DOGRULANMADI: profile not ready.",
      "enum": [
       "DOGRULANDI",
       "KISMI",
       "DOGRULANMADI"
      ]
     },
     "gerekceler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "tr": {
         "type": "string"
        },
        "en": {
         "type": "string"
        }
       },
       "required": [
        "tr",
        "en"
       ],
       "additionalProperties": false
      }
     }
    },
    "required": [
     "kod",
     "gerekceler"
    ],
    "additionalProperties": false,
    "description": "The seal states how well facts are tied to sources, not whether the content is true."
   },
   "DogrulamaVerisi": {
    "type": "object",
    "properties": {
     "surum": {
      "type": "integer"
     },
     "deneme": {
      "type": "boolean"
     },
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "profil_hazir": {
      "type": "boolean"
     },
     "muhur": {
      "$ref": "#/components/schemas/Muhur"
     },
     "veri_tamligi": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "bolum": {
         "type": "string"
        },
        "durum": {
         "type": "string",
         "enum": [
          "tam",
          "kismi",
          "yok",
          "hazirlaniyor",
          "yayimlanmiyor"
         ]
        },
        "yontem": {
         "type": [
          "string",
          "null"
         ]
        },
        "dayanak": {
         "type": [
          "integer",
          "null"
         ]
        },
        "sinirlar": {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        "yapisal": {
         "type": "boolean",
         "description": "Whether partial status is only a structural limit (joint-stock ownership)."
        }
       },
       "required": [
        "bolum",
        "durum",
        "yontem",
        "dayanak",
        "sinirlar",
        "yapisal"
       ],
       "additionalProperties": false
      }
     },
     "alintilar": {
      "type": "object",
      "properties": {
       "toplam": {
        "type": "integer"
       },
       "dogrulanan": {
        "type": "integer"
       },
       "dogrulanmayan": {
        "type": "integer"
       },
       "kaynaksiz": {
        "type": "integer"
       }
      },
      "required": [
       "toplam",
       "dogrulanan",
       "dogrulanmayan",
       "kaynaksiz"
      ],
      "additionalProperties": false
     },
     "kimlik": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "unvan": {
          "type": [
           "string",
           "null"
          ]
         },
         "tur": {
          "type": "string"
         },
         "merkez": {
          "type": "string"
         },
         "kurulus_tarihi": {
          "type": "string"
         },
         "sermaye": {
          "type": "string"
         },
         "hukuki_bicim": {
          "type": "string"
         },
         "hukuki_bicim_en": {
          "type": "string"
         },
         "kaynak": {
          "anyOf": [
           {
            "type": "object",
            "properties": {
             "ilan_id": {
              "type": "integer"
             },
             "tarih": {
              "type": "string",
              "description": "Notice date (DD.MM.YYYY)."
             },
             "sayi": {
              "type": "string",
              "description": "Gazette issue."
             },
             "sayfa": {
              "type": "string",
              "description": "Gazette page."
             },
             "alinti": {
              "type": "string",
              "description": "Short verbatim quote from the notice."
             },
             "dogrulandi": {
              "type": "boolean"
             }
            },
            "required": [
             "ilan_id",
             "tarih",
             "sayi",
             "sayfa",
             "alinti",
             "dogrulandi"
            ],
            "additionalProperties": false,
            "description": "Source notice reference (gazette date · issue · page) and quote."
           },
           {
            "type": "null"
           }
          ]
         }
        },
        "required": [
         "unvan",
         "tur",
         "merkez",
         "kurulus_tarihi",
         "sermaye",
         "hukuki_bicim",
         "hukuki_bicim_en",
         "kaynak"
        ],
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ]
     },
     "durum": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "kod": {
          "type": [
           "string",
           "null"
          ]
         },
         "ad": {
          "type": [
           "string",
           "null"
          ]
         },
         "ad_en": {
          "type": [
           "string",
           "null"
          ]
         },
         "uluslararasi": {
          "type": [
           "string",
           "null"
          ]
         },
         "yerel": {
          "type": "string"
         },
         "aciklama": {
          "type": "string"
         },
         "aciklama_en": {
          "type": "string"
         },
         "dayanak": {
          "type": "string"
         },
         "kaynak": {
          "anyOf": [
           {
            "type": "object",
            "properties": {
             "ilan_id": {
              "type": "integer"
             },
             "tarih": {
              "type": "string",
              "description": "Notice date (DD.MM.YYYY)."
             },
             "sayi": {
              "type": "string",
              "description": "Gazette issue."
             },
             "sayfa": {
              "type": "string",
              "description": "Gazette page."
             },
             "alinti": {
              "type": "string",
              "description": "Short verbatim quote from the notice."
             },
             "dogrulandi": {
              "type": "boolean"
             }
            },
            "required": [
             "ilan_id",
             "tarih",
             "sayi",
             "sayfa",
             "alinti",
             "dogrulandi"
            ],
            "additionalProperties": false,
            "description": "Source notice reference (gazette date · issue · page) and quote."
           },
           {
            "type": "null"
           }
          ]
         }
        },
        "required": [
         "kod",
         "ad",
         "ad_en",
         "uluslararasi",
         "yerel",
         "aciklama",
         "aciklama_en",
         "dayanak",
         "kaynak"
        ],
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ]
     },
     "yetkililer": {
      "type": [
       "array",
       "null"
      ],
      "description": "Officers in office (latest appointment per person).",
      "items": {
       "$ref": "#/components/schemas/RaporYetkilisi"
      }
     },
     "bitmis_gorunen_yetkililer": {
      "type": [
       "array",
       "null"
      ],
      "description": "Term lapsed and not named in the next election.",
      "items": {
       "$ref": "#/components/schemas/RaporYetkilisi"
      }
     },
     "sermaye": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "guncel": {
          "type": "string"
         },
         "kaynak": {
          "anyOf": [
           {
            "type": "object",
            "properties": {
             "ilan_id": {
              "type": "integer"
             },
             "tarih": {
              "type": "string",
              "description": "Notice date (DD.MM.YYYY)."
             },
             "sayi": {
              "type": "string",
              "description": "Gazette issue."
             },
             "sayfa": {
              "type": "string",
              "description": "Gazette page."
             },
             "alinti": {
              "type": "string",
              "description": "Short verbatim quote from the notice."
             },
             "dogrulandi": {
              "type": "boolean"
             }
            },
            "required": [
             "ilan_id",
             "tarih",
             "sayi",
             "sayfa",
             "alinti",
             "dogrulandi"
            ],
            "additionalProperties": false,
            "description": "Source notice reference (gazette date · issue · page) and quote."
           },
           {
            "type": "null"
           }
          ]
         },
         "gecmis": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "tarih": {
             "type": "string"
            },
            "islem": {
             "type": "string"
            },
            "onceki": {
             "type": "string"
            },
            "yeni": {
             "type": "string"
            },
            "kaynak": {
             "anyOf": [
              {
               "type": "object",
               "properties": {
                "ilan_id": {
                 "type": "integer"
                },
                "tarih": {
                 "type": "string",
                 "description": "Notice date (DD.MM.YYYY)."
                },
                "sayi": {
                 "type": "string",
                 "description": "Gazette issue."
                },
                "sayfa": {
                 "type": "string",
                 "description": "Gazette page."
                },
                "alinti": {
                 "type": "string",
                 "description": "Short verbatim quote from the notice."
                },
                "dogrulandi": {
                 "type": "boolean"
                }
               },
               "required": [
                "ilan_id",
                "tarih",
                "sayi",
                "sayfa",
                "alinti",
                "dogrulandi"
               ],
               "additionalProperties": false,
               "description": "Source notice reference (gazette date · issue · page) and quote."
              },
              {
               "type": "null"
              }
             ]
            }
           },
           "required": [
            "tarih",
            "islem",
            "onceki",
            "yeni",
            "kaynak"
           ],
           "additionalProperties": false
          }
         }
        },
        "required": [
         "guncel",
         "kaynak",
         "gecmis"
        ],
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ]
     },
     "ortaklar": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "anonim": {
          "type": "boolean"
         },
         "tarih": {
          "type": [
           "string",
           "null"
          ]
         },
         "liste": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "isim": {
             "type": [
              "string",
              "null"
             ]
            },
            "pay_tutari": {
             "type": "string"
            },
            "pay_orani": {
             "type": "string"
            },
            "kaynak": {
             "anyOf": [
              {
               "type": "object",
               "properties": {
                "ilan_id": {
                 "type": "integer"
                },
                "tarih": {
                 "type": "string",
                 "description": "Notice date (DD.MM.YYYY)."
                },
                "sayi": {
                 "type": "string",
                 "description": "Gazette issue."
                },
                "sayfa": {
                 "type": "string",
                 "description": "Gazette page."
                },
                "alinti": {
                 "type": "string",
                 "description": "Short verbatim quote from the notice."
                },
                "dogrulandi": {
                 "type": "boolean"
                }
               },
               "required": [
                "ilan_id",
                "tarih",
                "sayi",
                "sayfa",
                "alinti",
                "dogrulandi"
               ],
               "additionalProperties": false,
               "description": "Source notice reference (gazette date · issue · page) and quote."
              },
              {
               "type": "null"
              }
             ]
            }
           },
           "required": [
            "isim",
            "pay_tutari",
            "pay_orani",
            "kaynak"
           ],
           "additionalProperties": false
          }
         }
        },
        "required": [
         "anonim",
         "tarih",
         "liste"
        ],
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ]
     },
     "uyum": {
      "type": [
       "array",
       "null"
      ],
      "items": {
       "type": "object",
       "properties": {
        "tur": {
         "type": "string"
        },
        "ad": {
         "type": [
          "string",
          "null"
         ]
        },
        "ad_en": {
         "type": [
          "string",
          "null"
         ]
        },
        "aktif": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "aciklama": {
         "type": "string"
        },
        "aciklama_en": {
         "type": "string"
        },
        "dayanak": {
         "type": "string"
        },
        "tarih": {
         "type": "string"
        },
        "kaynak": {
         "anyOf": [
          {
           "type": "object",
           "properties": {
            "ilan_id": {
             "type": "integer"
            },
            "tarih": {
             "type": "string",
             "description": "Notice date (DD.MM.YYYY)."
            },
            "sayi": {
             "type": "string",
             "description": "Gazette issue."
            },
            "sayfa": {
             "type": "string",
             "description": "Gazette page."
            },
            "alinti": {
             "type": "string",
             "description": "Short verbatim quote from the notice."
            },
            "dogrulandi": {
             "type": "boolean"
            }
           },
           "required": [
            "ilan_id",
            "tarih",
            "sayi",
            "sayfa",
            "alinti",
            "dogrulandi"
           ],
           "additionalProperties": false,
           "description": "Source notice reference (gazette date · issue · page) and quote."
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "required": [
        "tur",
        "ad",
        "ad_en",
        "aktif",
        "aciklama",
        "aciklama_en",
        "dayanak",
        "tarih",
        "kaynak"
       ],
       "additionalProperties": false
      }
     },
     "yaptirim": {
      "type": "object",
      "properties": {
       "tarandi": {
        "type": "boolean"
       },
       "deneme": {
        "type": "boolean"
       },
       "taranan": {
        "type": "integer"
       },
       "isabetler": {
        "type": "array",
        "items": {
         "type": "object",
         "properties": {
          "ad": {
           "type": "string"
          },
          "rol": {
           "type": "string"
          },
          "liste": {
           "type": [
            "string",
            "null"
           ]
          },
          "liste_kaydi": {
           "type": "string"
          },
          "program": {
           "type": "string"
          }
         },
         "required": [
          "ad",
          "rol",
          "liste",
          "liste_kaydi",
          "program"
         ],
         "additionalProperties": false
        }
       },
       "liste_tarihi": {
        "type": "string"
       }
      },
      "required": [
       "tarandi",
       "deneme",
       "taranan",
       "isabetler",
       "liste_tarihi"
      ],
      "additionalProperties": false,
      "description": "Exact-name hits only; no screening in the sandbox."
     },
     "degisiklikler": {
      "type": "array",
      "description": "Last 10 changes.",
      "items": {
       "type": "object",
       "properties": {
        "tarih": {
         "type": "string"
        },
        "tur": {
         "type": "string"
        },
        "kategori": {
         "type": "string"
        },
        "ozet": {
         "type": "string"
        },
        "ozet_en": {
         "type": "string"
        },
        "kaynak": {
         "anyOf": [
          {
           "type": "object",
           "properties": {
            "ilan_id": {
             "type": "integer"
            },
            "tarih": {
             "type": "string",
             "description": "Notice date (DD.MM.YYYY)."
            },
            "sayi": {
             "type": "string",
             "description": "Gazette issue."
            },
            "sayfa": {
             "type": "string",
             "description": "Gazette page."
            },
            "alinti": {
             "type": "string",
             "description": "Short verbatim quote from the notice."
            },
            "dogrulandi": {
             "type": "boolean"
            }
           },
           "required": [
            "ilan_id",
            "tarih",
            "sayi",
            "sayfa",
            "alinti",
            "dogrulandi"
           ],
           "additionalProperties": false,
           "description": "Source notice reference (gazette date · issue · page) and quote."
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "required": [
        "tarih",
        "tur",
        "kategori",
        "ozet",
        "ozet_en",
        "kaynak"
       ],
       "additionalProperties": false
      }
     },
     "ilan_sayisi": {
      "type": "integer"
     }
    },
    "required": [
     "surum",
     "deneme",
     "sirket",
     "profil_hazir",
     "muhur",
     "veri_tamligi",
     "alintilar",
     "kimlik",
     "durum",
     "yetkililer",
     "bitmis_gorunen_yetkililer",
     "sermaye",
     "ortaklar",
     "uyum",
     "yaptirim",
     "degisiklikler",
     "ilan_sayisi"
    ],
    "additionalProperties": false,
    "description": "Language-independent snapshot of the report; dates DD.MM.YYYY."
   },
   "RaporYetkilisi": {
    "type": "object",
    "properties": {
     "isim": {
      "type": [
       "string",
       "null"
      ]
     },
     "sifat": {
      "type": "string"
     },
     "temsil": {
      "type": "string"
     },
     "baslangic": {
      "type": "string"
     },
     "gorev_bitis": {
      "type": "string"
     },
     "gorev_dayanak": {
      "type": "string"
     },
     "suresi_dolmus": {
      "type": "boolean"
     },
     "yeni_kurul": {
      "type": "string"
     },
     "derece": {
      "type": [
       "string",
       "null"
      ],
      "description": "Signing tier (1, 2…)."
     },
     "kaynak": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "ilan_id": {
          "type": "integer"
         },
         "tarih": {
          "type": "string",
          "description": "Notice date (DD.MM.YYYY)."
         },
         "sayi": {
          "type": "string",
          "description": "Gazette issue."
         },
         "sayfa": {
          "type": "string",
          "description": "Gazette page."
         },
         "alinti": {
          "type": "string",
          "description": "Short verbatim quote from the notice."
         },
         "dogrulandi": {
          "type": "boolean"
         }
        },
        "required": [
         "ilan_id",
         "tarih",
         "sayi",
         "sayfa",
         "alinti",
         "dogrulandi"
        ],
        "additionalProperties": false,
        "description": "Source notice reference (gazette date · issue · page) and quote."
       },
       {
        "type": "null"
       }
      ]
     },
     "temsil_kaynak": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "ilan_id": {
          "type": "integer"
         },
         "tarih": {
          "type": "string",
          "description": "Notice date (DD.MM.YYYY)."
         },
         "sayi": {
          "type": "string",
          "description": "Gazette issue."
         },
         "sayfa": {
          "type": "string",
          "description": "Gazette page."
         },
         "alinti": {
          "type": "string",
          "description": "Short verbatim quote from the notice."
         },
         "dogrulandi": {
          "type": "boolean"
         }
        },
        "required": [
         "ilan_id",
         "tarih",
         "sayi",
         "sayfa",
         "alinti",
         "dogrulandi"
        ],
        "additionalProperties": false,
        "description": "Source notice reference (gazette date · issue · page) and quote."
       },
       {
        "type": "null"
       }
      ]
     },
     "birlikte": {
      "type": "array",
      "description": "Who they may sign with under joint representation (officers in office only).",
      "items": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    },
    "required": [
     "isim",
     "sifat",
     "temsil",
     "baslangic",
     "gorev_bitis",
     "gorev_dayanak",
     "suresi_dolmus",
     "yeni_kurul",
     "derece",
     "kaynak",
     "temsil_kaynak"
    ],
    "additionalProperties": false
   },
   "DogrulamaRaporuJson": {
    "type": "object",
    "properties": {
     "rapor_kimligi": {
      "type": "string",
      "description": "DR-XXXX-XXXX-XXXX: from the content digest; same content → same id."
     },
     "muhur": {
      "type": "string",
      "enum": [
       "DOGRULANDI",
       "KISMI",
       "DOGRULANMADI"
      ]
     },
     "muhur_ad": {
      "type": "string"
     },
     "icerik_ozeti": {
      "type": "string",
      "description": "SHA-256 digest of the content."
     },
     "uretim_tarihi": {
      "type": "string",
      "format": "date"
     },
     "bekleyen_bolumler": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "veri": {
      "$ref": "#/components/schemas/DogrulamaVerisi"
     },
     "pdf": {
      "type": "string",
      "description": "PDF of the same report (free re-download with ?rapor=…).",
      "format": "uri"
     }
    },
    "required": [
     "rapor_kimligi",
     "muhur",
     "muhur_ad",
     "icerik_ozeti",
     "uretim_tarihi",
     "bekleyen_bolumler",
     "veri",
     "pdf"
    ],
    "additionalProperties": false
   },
   "ImzaKaynak": {
    "type": "object",
    "properties": {
     "ilan_id": {
      "type": "integer"
     },
     "ilan_tarihi": {
      "type": [
       "string",
       "null"
      ]
     },
     "sayi": {
      "type": "string"
     },
     "sayfa": {
      "type": "string"
     },
     "ilan_turu": {
      "type": "string"
     },
     "alinti": {
      "type": "string"
     },
     "alinti_dogrulandi": {
      "type": "boolean"
     },
     "gazete_pdf": {
      "type": [
       "string",
       "null"
      ],
      "format": "uri"
     }
    },
    "required": [
     "ilan_id",
     "ilan_tarihi",
     "sayi",
     "sayfa",
     "ilan_turu",
     "alinti",
     "alinti_dogrulandi",
     "gazete_pdf"
    ],
    "additionalProperties": false
   },
   "ImzaKontrolSonucu": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "kisi": {
      "type": "string"
     },
     "tarih": {
      "type": "string",
      "format": "date"
     },
     "islem": {
      "type": [
       "string",
       "null"
      ]
     },
     "tutar": {
      "type": [
       "number",
       "null"
      ]
     },
     "para_birimi": {
      "type": [
       "string",
       "null"
      ]
     },
     "sonuc": {
      "type": "string",
      "description": "yetkili (authorised) · yetkili_degil (not authorised) · belirsiz (undetermined; see reasons).",
      "enum": [
       "yetkili",
       "yetkili_degil",
       "belirsiz"
      ]
     },
     "sonuc_ad": {
      "type": "string"
     },
     "sonuc_en": {
      "type": "string"
     },
     "bicim": {
      "type": [
       "string",
       "null"
      ],
      "description": "Form of authority.",
      "enum": [
       "tek_basina",
       "birlikte",
       null
      ]
     },
     "bicim_ad": {
      "type": [
       "string",
       "null"
      ]
     },
     "bicim_en": {
      "type": [
       "string",
       "null"
      ]
     },
     "gerekceler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "kod": {
         "type": "string"
        },
        "etki": {
         "type": "string",
         "enum": [
          "olumlu",
          "olumsuz",
          "belirsiz",
          "bilgi"
         ]
        },
        "metin": {
         "type": "string"
        },
        "metin_en": {
         "type": "string"
        },
        "kaynak": {
         "anyOf": [
          {
           "$ref": "#/components/schemas/ImzaKaynak"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "required": [
        "kod",
        "etki",
        "metin",
        "metin_en",
        "kaynak"
       ],
       "additionalProperties": false
      }
     },
     "kurallar": {
      "type": "array",
      "description": "Representation rules applied (notice or internal directive).",
      "items": {
       "type": "object",
       "properties": {
        "kapsam": {
         "type": "string"
        },
        "bicim": {
         "type": [
          "string",
          "null"
         ]
        },
        "tutar_siniri": {
         "type": [
          "string",
          "null"
         ]
        },
        "kim": {
         "type": "string"
        },
        "madde": {
         "type": "string"
        },
        "birlikte_imza": {
         "type": "array",
         "items": {
          "type": [
           "string",
           "null"
          ]
         }
        },
        "alinti": {
         "type": "string"
        },
        "ilan": {
         "anyOf": [
          {
           "$ref": "#/components/schemas/ImzaKaynak"
          },
          {
           "type": "null"
          }
         ]
        },
        "kaynak_turu": {
         "type": "string",
         "enum": [
          "ilan",
          "ic_yonerge"
         ]
        }
       },
       "required": [
        "kapsam",
        "bicim",
        "tutar_siniri",
        "kim",
        "madde",
        "birlikte_imza",
        "alinti",
        "ilan",
        "kaynak_turu"
       ],
       "additionalProperties": false
      }
     },
     "birlikte_imza": {
      "type": "array",
      "description": "Who may co-sign under joint representation.",
      "items": {
       "type": [
        "string",
        "null"
       ]
      }
     },
     "gorev_kayitlari": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "isim": {
         "type": [
          "string",
          "null"
         ]
        },
        "sifat": {
         "type": [
          "string",
          "null"
         ]
        },
        "temsil": {
         "type": [
          "string",
          "null"
         ]
        },
        "baslangic": {
         "type": [
          "string",
          "null"
         ]
        },
        "bitis": {
         "type": [
          "string",
          "null"
         ]
        },
        "bitis_nedeni": {
         "type": [
          "string",
          "null"
         ]
        },
        "gorev_bitis": {
         "type": [
          "string",
          "null"
         ]
        },
        "gorev_dayanak": {
         "type": [
          "string",
          "null"
         ]
        },
        "kaynak": {
         "anyOf": [
          {
           "$ref": "#/components/schemas/ImzaKaynak"
          },
          {
           "type": "null"
          }
         ]
        },
        "bitis_kaynak": {
         "anyOf": [
          {
           "$ref": "#/components/schemas/ImzaKaynak"
          },
          {
           "type": "null"
          }
         ]
        },
        "temsil_kaynak": {
         "anyOf": [
          {
           "$ref": "#/components/schemas/ImzaKaynak"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "required": [
        "isim",
        "sifat",
        "temsil",
        "baslangic",
        "bitis",
        "bitis_nedeni",
        "gorev_bitis",
        "gorev_dayanak",
        "kaynak",
        "bitis_kaynak",
        "temsil_kaynak"
       ],
       "additionalProperties": false
      }
     },
     "profil_hazir": {
      "type": "boolean"
     },
     "sinirlar": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "sinirlar_en": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "uyari": {
      "type": "string",
      "description": "Based on notices; confirm against the current signature circular."
     },
     "uyari_en": {
      "type": "string"
     }
    },
    "required": [
     "sirket",
     "kisi",
     "tarih",
     "islem",
     "tutar",
     "para_birimi",
     "sonuc",
     "sonuc_ad",
     "sonuc_en",
     "bicim",
     "bicim_ad",
     "bicim_en",
     "gerekceler",
     "kurallar",
     "birlikte_imza",
     "gorev_kayitlari",
     "profil_hazir",
     "sinirlar",
     "sinirlar_en",
     "uyari",
     "uyari_en"
    ],
    "additionalProperties": false
   },
   "ImzaKisiListesi": {
    "type": "object",
    "properties": {
     "sirket": {
      "$ref": "#/components/schemas/SirketOzet"
     },
     "profil_hazir": {
      "type": "boolean"
     },
     "kisiler": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "isim": {
         "type": [
          "string",
          "null"
         ]
        },
        "gorevde": {
         "type": "boolean"
        }
       },
       "required": [
        "isim",
        "gorevde"
       ],
       "additionalProperties": false
      }
     }
    },
    "required": [
     "sirket",
     "profil_hazir",
     "kisiler"
    ],
    "additionalProperties": false,
    "description": "GET without `kisi`: officer names in the profile."
   },
   "HizliSorguAdayi": {
    "type": "object",
    "properties": {
     "ulke": {
      "type": "string",
      "description": "ISO country code (TR; abroad the record's country, ZZ = LEI)."
     },
     "kimlik": {
      "type": "string",
      "description": "Index id: in Turkey `OFFICE/registry root` (e.g. İSTANBUL/325075), abroad the registry id."
     },
     "mudurluk": {
      "type": [
       "string",
       "null"
      ],
      "description": "Trade registry office (Turkey only); pass it to `sirket-ekle` as is."
     },
     "sicil_no": {
      "type": [
       "string",
       "null"
      ],
      "description": "Registry number (Turkey only)."
     },
     "unvan": {
      "type": "string",
      "description": "Name (in Turkey as written in the latest gazette notice)."
     },
     "hukuki_bicim": {
      "type": "object",
      "properties": {
       "kod": {
        "type": "string",
        "description": "Ulawk form code (TR_AS, TR_LTD, YB_GMBH …; BILINMIYOR if unknown)."
       },
       "yerel": {
        "type": [
         "string",
         "null"
        ],
        "description": "Local name."
       },
       "en": {
        "type": [
         "string",
         "null"
        ],
        "description": "English name."
       },
       "iso": {
        "type": [
         "string",
         "null"
        ],
        "description": "ISO 20275 (ELF) code; null without an exact match in the list."
       },
       "kategori": {
        "type": "string",
        "description": "Standard category: ANONIM, LIMITED, SAHIS_SIRKETI, KOOPERATIF, SUBE …"
       }
      },
      "required": [
       "kod",
       "yerel",
       "en",
       "iso",
       "kategori"
      ],
      "additionalProperties": false
     },
     "durum": {
      "type": "object",
      "properties": {
       "kod": {
        "type": "string",
        "enum": [
         "FAAL",
         "IFLAS_KONKORDATO",
         "TASFIYEDE",
         "KAPANDI",
         "BILINMIYOR"
        ]
       },
       "ad": {
        "type": "string"
       },
       "yerel": {
        "type": "string",
        "description": "Wording in the source or notice."
       },
       "uluslararasi": {
        "type": "string",
        "description": "International equivalent (ACTIVE, PENDING_DISSOLUTION, CLOSED …)."
       }
      },
      "required": [
       "kod",
       "ad",
       "yerel",
       "uluslararasi"
      ],
      "additionalProperties": false
     },
     "il": {
      "type": [
       "string",
       "null"
      ],
      "description": "Province (from the registry office; Turkey only)."
     },
     "adres": {
      "type": [
       "string",
       "null"
      ],
      "description": "Registered address (from the identity section of the sourced profile; null if none)."
     },
     "kurulus": {
      "type": [
       "string",
       "null"
      ],
      "description": "Incorporation date (YYYY-MM-DD) or null.",
      "format": "date"
     },
     "son_ilan_tarihi": {
      "type": [
       "string",
       "null"
      ],
      "description": "Latest notice/event date in the index.",
      "format": "date"
     },
     "kaynak": {
      "type": "string",
      "enum": [
       "ulawk_dizini"
      ]
     },
     "guncellik_tarihi": {
      "type": [
       "string",
       "null"
      ],
      "description": "The day Ulawk last observed the data; it does not mean the answer is current.",
      "format": "date"
     },
     "eslesme": {
      "type": "string",
      "description": "tam: registry no / id exact or same bare name · yakin: name starts with the query or is very similar · kismi: all words appear.",
      "enum": [
       "tam",
       "yakin",
       "kismi"
      ]
     },
     "skor": {
      "type": "number",
      "description": "0–1 similarity.",
      "minimum": 0,
      "maximum": 1
     },
     "takipte": {
      "type": "boolean",
      "description": "Whether the company is on YOUR list (other customers' lists are never disclosed)."
     },
     "sirket_id": {
      "type": [
       "integer",
       "string",
       "null"
      ],
      "description": "Your company id when followed (`/api/v1/sirketler/{id}/`)."
     },
     "profil": {
      "type": [
       "string",
       "null"
      ],
      "description": "Sourced profile address when followed.",
      "format": "uri"
     }
    },
    "required": [
     "ulke",
     "kimlik",
     "mudurluk",
     "sicil_no",
     "unvan",
     "hukuki_bicim",
     "durum",
     "il",
     "adres",
     "kurulus",
     "son_ilan_tarihi",
     "kaynak",
     "guncellik_tarihi",
     "eslesme",
     "skor",
     "takipte",
     "sirket_id",
     "profil"
    ],
    "additionalProperties": false,
    "description": "Index candidate: company-level fields only; no personal names."
   },
   "HizliSorguYaniti": {
    "type": "object",
    "properties": {
     "sorgu": {
      "type": "string"
     },
     "ulke": {
      "type": [
       "string",
       "null"
      ],
      "description": "Country filter or null (all)."
     },
     "adet": {
      "type": "integer"
     },
     "kaynak": {
      "type": "string",
      "enum": [
       "ulawk_dizini"
      ]
     },
     "bulunamadi": {
      "type": "boolean",
      "description": "No candidate in the index: follow the company to build a sourced profile."
     },
     "aciklama": {
      "type": "string"
     },
     "takibe_al": {
      "type": "string",
      "description": "Follow endpoint (`POST`).",
      "format": "uri"
     },
     "adaylar": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/HizliSorguAdayi"
      }
     }
    },
    "required": [
     "sorgu",
     "ulke",
     "adet",
     "kaynak",
     "bulunamadi",
     "aciklama",
     "takibe_al",
     "adaylar"
    ],
    "additionalProperties": false
   }
  },
  "securitySchemes": {
   "anahtar": {
    "type": "apiKey",
    "in": "header",
    "name": "X-API-Key",
    "description": "Key from Panel › API keys (ulk_…)."
   },
   "gizli": {
    "type": "apiKey",
    "in": "header",
    "name": "X-API-Secret",
    "description": "The key's secret pair (ulsk_…); shown once, when created."
   }
  }
 },
 "x-ulawk-kategoriler": {
  "durum": "Company status",
  "adres": "Address",
  "ortaklik": "Ownership",
  "sermaye": "Capital",
  "yetkililer": "Officers and representation",
  "unvan": "Name",
  "esas_sozlesme": "Articles of association",
  "diger": "Other",
  "kapandi": "Closure (struck off)"
 }
}