{
  "components": {
    "schemas": {
      "AccessInfo": {
        "additionalProperties": false,
        "properties": {
          "paid": {
            "type": "boolean"
          }
        },
        "required": [
          "paid"
        ],
        "type": "object"
      },
      "AccountingLine": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "current_value": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "previous_value": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "current_value",
          "name",
          "previous_value"
        ],
        "type": "object"
      },
      "AccountingReport": {
        "additionalProperties": false,
        "properties": {
          "chief_name": {
            "type": "string"
          },
          "sections": {
            "items": {
              "$ref": "#/components/schemas/AccountingSection"
            },
            "type": "array"
          }
        },
        "required": [
          "chief_name",
          "sections"
        ],
        "type": "object"
      },
      "AccountingSection": {
        "additionalProperties": false,
        "properties": {
          "lines": {
            "items": {
              "$ref": "#/components/schemas/AccountingLine"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "lines",
          "name"
        ],
        "type": "object"
      },
      "Accreditation": {
        "additionalProperties": false,
        "properties": {
          "certificate_number": {
            "type": "string"
          },
          "issued_date": {
            "type": "string"
          },
          "program_code": {
            "type": "string"
          },
          "program_name": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "valid_until": {
            "type": "string"
          }
        },
        "required": [
          "program_code"
        ],
        "type": "object"
      },
      "AccreditationsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Accreditation"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "Address": {
        "additionalProperties": false,
        "properties": {
          "city": {
            "type": "string"
          },
          "full": {
            "type": "string"
          },
          "postal_code": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "street": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "AdvancedSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "description": "Filter by active/inactive status; multiple values mean \"any of these\".",
            "items": {
              "type": "boolean"
            },
            "type": "array"
          },
          "employee_count": {
            "description": "Employee-count range (country-specific, e.g. KZ \"от 6 до 10 чел.\").",
            "type": "string"
          },
          "end_date": {
            "description": "Registered on or before this date (YYYY-MM-DD).",
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "description": "Country-specific filter fields — the per-country filter channel. Keys are interpreted by the country provider (mirrors the tender search). Generic filters above stay first-class; only genuinely country-unique filters go here.",
            "type": "object"
          },
          "industry_code": {
            "type": "string"
          },
          "legal_form": {
            "description": "Legal-form filter using the canonical values \"legal_entity\" or \"sole_trader\" (the values advertised in /info Filters.LegalForms).",
            "type": "string"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "query": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "size": {
            "description": "Company size category (country-specific, e.g. KZ \"Малые предприятия\").",
            "type": "string"
          },
          "start_date": {
            "description": "Registered on or after this date (YYYY-MM-DD).",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "AffiliationItem": {
        "additionalProperties": false,
        "properties": {
          "direction": {
            "enum": [
              "up",
              "down"
            ],
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "registration_number"
        ],
        "type": "object"
      },
      "AffiliationsResult": {
        "additionalProperties": false,
        "properties": {
          "head": {
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/AffiliationItem"
            },
            "type": "array"
          },
          "legal_form": {
            "description": "Canonical legal form (\"sole_trader\" / \"legal_entity\").",
            "type": "string"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "AlternativesResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/DiscoveryItem"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "Arrest": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "format": "double",
            "type": "number"
          },
          "authority": {
            "type": "string"
          },
          "collector": {
            "type": "string"
          },
          "collector_registration_number": {
            "type": "string"
          },
          "collector_type": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "date": {
            "format": "date-time",
            "type": "string"
          },
          "debt_amount": {
            "format": "double",
            "type": "number"
          },
          "department": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "number": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "ArrestCheck": {
        "additionalProperties": false,
        "properties": {
          "found": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "found"
        ],
        "type": "object"
      },
      "ArrestsResult": {
        "additionalProperties": false,
        "properties": {
          "active_sum": {
            "format": "double",
            "type": "number"
          },
          "active_total": {
            "format": "int64",
            "type": "integer"
          },
          "checks": {
            "items": {
              "$ref": "#/components/schemas/ArrestCheck"
            },
            "type": "array"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Arrest"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "returned_sum": {
            "format": "double",
            "type": "number"
          },
          "returned_total": {
            "format": "int64",
            "type": "integer"
          },
          "sum": {
            "format": "double",
            "type": "number"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "checks",
          "page",
          "per_page",
          "total_count",
          "sum",
          "active_total",
          "active_sum",
          "returned_total",
          "returned_sum"
        ],
        "type": "object"
      },
      "BankAccount": {
        "additionalProperties": false,
        "properties": {
          "account_num": {
            "type": "string"
          },
          "bank_code": {
            "type": "string"
          },
          "bank_name": {
            "type": "string"
          }
        },
        "required": [
          "account_num",
          "bank_code",
          "bank_name"
        ],
        "type": "object"
      },
      "BankAccountsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/BankAccount"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "BatchCreateRequest": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "registration_numbers": {
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          }
        },
        "required": [
          "registration_numbers"
        ],
        "type": "object"
      },
      "BatchJob": {
        "additionalProperties": false,
        "properties": {
          "completed_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "failed_items": {
            "format": "int64",
            "type": "integer"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "processed_items": {
            "format": "int64",
            "type": "integer"
          },
          "status": {
            "enum": [
              "pending",
              "processing",
              "completed",
              "failed"
            ],
            "type": "string"
          },
          "total_items": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "created_at",
          "failed_items",
          "id",
          "processed_items",
          "status",
          "total_items"
        ],
        "type": "object"
      },
      "BatchJobGlobal": {
        "additionalProperties": false,
        "properties": {
          "completed_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "failed_items": {
            "format": "int64",
            "type": "integer"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "processed_items": {
            "format": "int64",
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "total_items": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "created_at",
          "failed_items",
          "id",
          "processed_items",
          "status",
          "total_items"
        ],
        "type": "object"
      },
      "BatchListGlobalResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/BatchJobGlobal"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "BatchListResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/BatchJob"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "BatchResultItem": {
        "additionalProperties": false,
        "properties": {
          "company": {
            "$ref": "#/components/schemas/CompanyCard"
          },
          "company_id": {
            "format": "int64",
            "type": "integer"
          },
          "contracts_count": {
            "format": "int64",
            "type": "integer"
          },
          "court_cases_count": {
            "format": "int64",
            "type": "integer"
          },
          "error_message": {
            "type": "string"
          },
          "finance": {
            "$ref": "#/components/schemas/FinancialReport"
          },
          "licenses_count": {
            "format": "int64",
            "type": "integer"
          },
          "registration_number": {
            "type": "string"
          },
          "risks": {
            "items": {
              "$ref": "#/components/schemas/Risk"
            },
            "type": "array"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "registration_number",
          "status"
        ],
        "type": "object"
      },
      "BatchResultsResponse": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/BatchResultItem"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "Branch": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "$ref": "#/components/schemas/Address"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "registration_number"
        ],
        "type": "object"
      },
      "BranchesResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Branch"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "CatalogResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/DiscoveryItem"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "stats": {
            "$ref": "#/components/schemas/CatalogStats"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "CatalogStats": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "format": "int64",
            "type": "integer"
          },
          "inactive": {
            "format": "int64",
            "type": "integer"
          },
          "top_industries": {
            "items": {
              "$ref": "#/components/schemas/IndustryCount"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "Certificate": {
        "additionalProperties": false,
        "properties": {
          "expiry_date": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "issued_by": {
            "type": "string"
          },
          "issued_date": {
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "number": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "CertificatesMeta": {
        "additionalProperties": false,
        "properties": {
          "counts": {
            "additionalProperties": {
              "format": "int64",
              "type": "integer"
            },
            "type": "object"
          },
          "total": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "counts",
          "total"
        ],
        "type": "object"
      },
      "CertificatesResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Certificate"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "CompanyCard": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "address": {
            "$ref": "#/components/schemas/Address"
          },
          "country_code": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "employee_count": {
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "description": "Country-specific fields. KZ: kato, kse, kfc, rnn; plus the tax-authority (КГД) overlay — sur_level (low|medium|high) with sur_tone (safe|warn|risk), and vat_status (registered|deregistered|none) with vat_registration_date / vat_deregistration_date. A КГД key is absent when the source has no verdict; absence is never a negative answer.",
            "type": "object"
          },
          "full_name": {
            "type": "string"
          },
          "head": {
            "$ref": "#/components/schemas/Person"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "identifiers": {
            "items": {
              "$ref": "#/components/schemas/CompanyIdentifier"
            },
            "type": "array"
          },
          "industry_code": {
            "type": "string"
          },
          "industry_codes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "industry_name": {
            "type": "string"
          },
          "legal_form": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "name_local": {
            "type": "string"
          },
          "old_heads": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "paid": {
            "type": "boolean"
          },
          "registration_date": {
            "format": "date-time",
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "roles": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "status": {
            "description": "Raw registry status string (localized by the source).",
            "type": "string"
          },
          "status_code": {
            "description": "Normalized status code — map to a label, do not display raw. One of: active, dormant (active=false), liquidated (terminal, per the tax authority; overrides the registry status).",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "active",
          "country_code",
          "created_at",
          "id",
          "name",
          "paid",
          "registration_number",
          "updated_at"
        ],
        "type": "object"
      },
      "CompanyIdentifier": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "value"
        ],
        "type": "object"
      },
      "ContactsResult": {
        "additionalProperties": false,
        "properties": {
          "emails": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "phones": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          },
          "websites": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "emails",
          "phones",
          "websites",
          "total_count"
        ],
        "type": "object"
      },
      "Contract": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "format": "double",
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "customer_name": {
            "type": "string"
          },
          "customer_reg_num": {
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "type": "object"
          },
          "id": {
            "type": "string"
          },
          "number": {
            "type": "string"
          },
          "sign_date": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "subject": {
            "type": "string"
          },
          "supplier_name": {
            "type": "string"
          },
          "supplier_reg_num": {
            "type": "string"
          }
        },
        "required": [
          "amount",
          "id",
          "number"
        ],
        "type": "object"
      },
      "ContractsByYear": {
        "additionalProperties": false,
        "properties": {
          "customer": {
            "items": {
              "$ref": "#/components/schemas/ContractsYearStat"
            },
            "type": "array"
          },
          "supplier": {
            "items": {
              "$ref": "#/components/schemas/ContractsYearStat"
            },
            "type": "array"
          }
        },
        "required": [
          "customer",
          "supplier"
        ],
        "type": "object"
      },
      "ContractsMeta": {
        "additionalProperties": false,
        "properties": {
          "as_customer": {
            "format": "int64",
            "type": "integer"
          },
          "as_supplier": {
            "format": "int64",
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "government_entity": {
            "format": "int64",
            "type": "integer"
          },
          "sum_vat": {
            "format": "double",
            "type": "number"
          },
          "total_amount": {
            "format": "double",
            "type": "number"
          },
          "total_contracts": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "as_customer",
          "as_supplier",
          "total_amount",
          "total_contracts"
        ],
        "type": "object"
      },
      "ContractsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Contract"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "ContractsYearStat": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "government_entity": {
            "format": "int64",
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "status_id": {
            "format": "int64",
            "type": "integer"
          },
          "sum": {
            "format": "double",
            "type": "number"
          },
          "sum_vat": {
            "format": "double",
            "type": "number"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "count",
          "sum",
          "year"
        ],
        "type": "object"
      },
      "CountryClassifier": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "name"
        ],
        "type": "object"
      },
      "CountryClassifierExtra": {
        "additionalProperties": false,
        "properties": {
          "header": {
            "type": "boolean"
          },
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "label"
        ],
        "type": "object"
      },
      "CountryClassifiers": {
        "additionalProperties": false,
        "properties": {
          "activity": {
            "$ref": "#/components/schemas/CountryClassifier"
          },
          "extra": {
            "items": {
              "$ref": "#/components/schemas/CountryClassifierExtra"
            },
            "type": "array"
          },
          "region": {
            "$ref": "#/components/schemas/CountryClassifier"
          }
        },
        "required": [
          "activity",
          "region",
          "extra"
        ],
        "type": "object"
      },
      "CountryCurrency": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "locale": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "symbol",
          "locale"
        ],
        "type": "object"
      },
      "CountryFilterOption": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "value"
        ],
        "type": "object"
      },
      "CountryFilters": {
        "additionalProperties": false,
        "properties": {
          "legalForms": {
            "items": {
              "$ref": "#/components/schemas/CountryFilterOption"
            },
            "type": "array"
          },
          "sizeClasses": {
            "items": {
              "$ref": "#/components/schemas/CountryFilterOption"
            },
            "type": "array"
          }
        },
        "required": [
          "legalForms",
          "sizeClasses"
        ],
        "type": "object"
      },
      "CountryIdentifier": {
        "additionalProperties": false,
        "properties": {
          "appliesTo": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "code": {
            "type": "string"
          },
          "full": {
            "type": "string"
          },
          "length": {
            "format": "int64",
            "type": "integer"
          },
          "personal": {
            "type": "boolean"
          },
          "primary": {
            "type": "boolean"
          },
          "role": {
            "type": "string"
          },
          "short": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "short",
          "full",
          "length",
          "role",
          "primary",
          "appliesTo"
        ],
        "type": "object"
      },
      "CountryInfo": {
        "additionalProperties": false,
        "properties": {
          "classifiers": {
            "$ref": "#/components/schemas/CountryClassifiers"
          },
          "code": {
            "type": "string"
          },
          "currency": {
            "$ref": "#/components/schemas/CountryCurrency"
          },
          "filters": {
            "$ref": "#/components/schemas/CountryFilters"
          },
          "flag": {
            "type": "string"
          },
          "identifiers": {
            "items": {
              "$ref": "#/components/schemas/CountryIdentifier"
            },
            "type": "array"
          },
          "locale": {
            "$ref": "#/components/schemas/CountryLocale"
          },
          "map": {
            "$ref": "#/components/schemas/CountryMap"
          },
          "name": {
            "$ref": "#/components/schemas/CountryName"
          },
          "regions": {
            "items": {
              "$ref": "#/components/schemas/CountryRegion"
            },
            "type": "array"
          },
          "sources": {
            "items": {
              "$ref": "#/components/schemas/CountrySource"
            },
            "type": "array"
          },
          "tax": {
            "$ref": "#/components/schemas/CountryTax"
          },
          "tools": {
            "items": {
              "$ref": "#/components/schemas/CountryTool"
            },
            "type": "array"
          }
        },
        "required": [
          "code",
          "name",
          "flag",
          "currency",
          "identifiers",
          "locale",
          "classifiers",
          "tax",
          "sources",
          "tools",
          "map",
          "filters",
          "regions"
        ],
        "type": "object"
      },
      "CountryLocale": {
        "additionalProperties": false,
        "properties": {
          "dateFormat": {
            "type": "string"
          },
          "default": {
            "type": "string"
          },
          "numberLocale": {
            "type": "string"
          },
          "phoneCode": {
            "type": "string"
          }
        },
        "required": [
          "default",
          "phoneCode",
          "dateFormat",
          "numberLocale"
        ],
        "type": "object"
      },
      "CountryMap": {
        "additionalProperties": false,
        "properties": {
          "available": {
            "type": "boolean"
          }
        },
        "required": [
          "available"
        ],
        "type": "object"
      },
      "CountryName": {
        "additionalProperties": false,
        "properties": {
          "en": {
            "type": "string"
          },
          "genitive": {
            "type": "string"
          },
          "kk": {
            "type": "string"
          },
          "nominative": {
            "type": "string"
          },
          "prepositional": {
            "type": "string"
          }
        },
        "required": [
          "nominative",
          "genitive",
          "prepositional",
          "en",
          "kk"
        ],
        "type": "object"
      },
      "CountryRegion": {
        "additionalProperties": false,
        "properties": {
          "apiValue": {
            "type": "string"
          },
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "kato": {
            "type": "string"
          },
          "name": {
            "$ref": "#/components/schemas/CountryRegionName"
          },
          "slug": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "apiValue",
          "name",
          "count"
        ],
        "type": "object"
      },
      "CountryRegionName": {
        "additionalProperties": false,
        "properties": {
          "genitive": {
            "type": "string"
          },
          "nominative": {
            "type": "string"
          }
        },
        "required": [
          "nominative",
          "genitive"
        ],
        "type": "object"
      },
      "CountrySource": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "type": "string"
          },
          "itemUrlTemplate": {
            "type": "string"
          },
          "key": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "name",
          "description",
          "url"
        ],
        "type": "object"
      },
      "CountryTax": {
        "additionalProperties": false,
        "properties": {
          "vatApplicable": {
            "type": "boolean"
          }
        },
        "required": [
          "vatApplicable"
        ],
        "type": "object"
      },
      "CountryTool": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name"
        ],
        "type": "object"
      },
      "CourtCase": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "format": "double",
            "type": "number"
          },
          "case_number": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "court": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "defendants": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "end_date": {
            "format": "date-time",
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "type": "object"
          },
          "plaintiffs": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "start_date": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "case_number"
        ],
        "type": "object"
      },
      "CourtCasesMeta": {
        "additionalProperties": false,
        "properties": {
          "active_cases": {
            "format": "int64",
            "type": "integer"
          },
          "as_defendant": {
            "format": "int64",
            "type": "integer"
          },
          "as_plaintiff": {
            "format": "int64",
            "type": "integer"
          },
          "by_category": {
            "items": {
              "$ref": "#/components/schemas/CourtCategoryCount"
            },
            "type": "array"
          },
          "completed_cases": {
            "format": "int64",
            "type": "integer"
          },
          "total_cases": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "active_cases",
          "as_defendant",
          "as_plaintiff",
          "by_category",
          "completed_cases",
          "total_cases"
        ],
        "type": "object"
      },
      "CourtCasesResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/CourtCase"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "CourtCategoryCount": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "code",
          "count"
        ],
        "type": "object"
      },
      "CourtWorkerStatus": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "type": "string"
          },
          "current_area": {
            "type": "string"
          },
          "current_court": {
            "type": "string"
          },
          "current_year": {
            "format": "int64",
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "type": "object"
      },
      "DiscoveryItem": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "address_area": {
            "type": "string"
          },
          "address_full": {
            "type": "string"
          },
          "employee_count": {
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "description": "Country-specific fields (e.g. KZ kato, kse, kfc).",
            "type": "object"
          },
          "head": {
            "type": "string"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "industry": {
            "type": "string"
          },
          "industry_code": {
            "type": "string"
          },
          "legal_form": {
            "description": "Canonical legal form (\"sole_trader\" / \"legal_entity\").",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "registration_date": {
            "format": "date-time",
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "status_code": {
            "description": "Normalized status code — map to a label, do not display raw. active | dormant. NOTE: unlike the company card this never reports \"liquidated\": tax-authority liquidation is not indexed, so list views cannot see it.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "registration_number",
          "name"
        ],
        "type": "object"
      },
      "Employee": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "position": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "EmployeesInfo": {
        "additionalProperties": false,
        "properties": {
          "employees": {
            "items": {
              "$ref": "#/components/schemas/Employee"
            },
            "type": "array"
          }
        },
        "required": [
          "employees"
        ],
        "type": "object"
      },
      "ErrorDetail": {
        "additionalProperties": false,
        "properties": {
          "location": {
            "description": "Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'",
            "type": "string"
          },
          "message": {
            "description": "Error message text",
            "type": "string"
          },
          "value": {
            "description": "The value at the given location"
          }
        },
        "type": "object"
      },
      "ErrorModel": {
        "additionalProperties": false,
        "properties": {
          "detail": {
            "description": "A human-readable explanation specific to this occurrence of the problem.",
            "examples": [
              "Property foo is required but is missing."
            ],
            "type": "string"
          },
          "errors": {
            "description": "Optional list of individual error details",
            "items": {
              "$ref": "#/components/schemas/ErrorDetail"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "instance": {
            "description": "A URI reference that identifies the specific occurrence of the problem.",
            "examples": [
              "https://example.com/error-log/abc123"
            ],
            "format": "uri",
            "type": "string"
          },
          "status": {
            "description": "HTTP status code",
            "examples": [
              400
            ],
            "format": "int64",
            "type": "integer"
          },
          "title": {
            "description": "A short, human-readable summary of the problem type. This value should not change between occurrences of the error.",
            "examples": [
              "Bad Request"
            ],
            "type": "string"
          },
          "type": {
            "default": "about:blank",
            "description": "A URI reference to human-readable documentation for the error.",
            "examples": [
              "https://example.com/errors/example"
            ],
            "format": "uri",
            "type": "string"
          }
        },
        "type": "object"
      },
      "EstimatedProfit": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "profit": {
            "format": "double",
            "type": "number"
          },
          "rate": {
            "format": "double",
            "type": "number"
          },
          "tax": {
            "format": "double",
            "type": "number"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "currency",
          "profit",
          "rate",
          "tax",
          "year"
        ],
        "type": "object"
      },
      "EstimatedProfitResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/EstimatedProfit"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "Event": {
        "additionalProperties": false,
        "properties": {
          "date": {
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "new_value": {
            "type": "string"
          },
          "old_value": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "EventTypeCount": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "count"
        ],
        "type": "object"
      },
      "EventsMeta": {
        "additionalProperties": false,
        "properties": {
          "by_type": {
            "items": {
              "$ref": "#/components/schemas/EventTypeCount"
            },
            "type": "array"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "by_type",
          "total_count"
        ],
        "type": "object"
      },
      "EventsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Event"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "Features": {
        "additionalProperties": false,
        "properties": {
          "accreditations": {
            "type": "boolean"
          },
          "arrest": {
            "type": "boolean"
          },
          "bank": {
            "type": "boolean"
          },
          "certificate": {
            "type": "boolean"
          },
          "company": {
            "type": "boolean"
          },
          "court": {
            "type": "boolean"
          },
          "founders": {
            "type": "boolean"
          },
          "head_participation": {
            "type": "boolean"
          },
          "procurement": {
            "type": "boolean"
          },
          "risk": {
            "type": "boolean"
          },
          "search": {
            "type": "boolean"
          },
          "tax": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "FinancesResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/FinancialReport"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "FinancialReport": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "expense": {
            "format": "double",
            "type": "number"
          },
          "extra": {
            "additionalProperties": {},
            "type": "object"
          },
          "profit": {
            "format": "double",
            "type": "number"
          },
          "revenue": {
            "format": "double",
            "type": "number"
          },
          "type": {
            "type": "string"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "currency",
          "expense",
          "profit",
          "revenue",
          "year",
          "type"
        ],
        "type": "object"
      },
      "Founder": {
        "additionalProperties": false,
        "properties": {
          "inactive": {
            "type": "boolean"
          },
          "is_person": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "share": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "name",
          "is_person",
          "share",
          "inactive"
        ],
        "type": "object"
      },
      "FoundersResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Founder"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "HeadParticipationItem": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "address_area": {
            "type": "string"
          },
          "head": {
            "description": "That entity's CURRENT head — the same person for a 'current' row, their successor for a 'former' one.",
            "type": "string"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "industry": {
            "type": "string"
          },
          "industry_code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "registration_date": {
            "format": "date-time",
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "role": {
            "description": "'current' — the head runs it now; 'former' — they used to.",
            "enum": [
              "current",
              "former"
            ],
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "sole_trader": {
            "type": "boolean"
          },
          "staff_number": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "registration_number",
          "name",
          "head",
          "role",
          "size",
          "staff_number",
          "industry_code",
          "industry",
          "address_area",
          "active",
          "sole_trader"
        ],
        "type": "object"
      },
      "HeadParticipationResult": {
        "additionalProperties": false,
        "properties": {
          "head": {
            "description": "The subject company's head ФИО — the term the search ran on.",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/HeadParticipationItem"
            },
            "type": "array"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total_count"
        ],
        "type": "object"
      },
      "IndustryCount": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "License": {
        "additionalProperties": false,
        "properties": {
          "expiry_date": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "issued_by": {
            "type": "string"
          },
          "issued_date": {
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "number": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "LicensesResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/License"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "NewsItem": {
        "additionalProperties": false,
        "properties": {
          "link": {
            "type": "string"
          },
          "pub_date": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "source_link": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "type": "object"
      },
      "NewsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/NewsItem"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "Person": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "position": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "PropertyItem": {
        "additionalProperties": false,
        "properties": {
          "by_year": {
            "items": {
              "$ref": "#/components/schemas/PropertyYear"
            },
            "type": "array"
          },
          "kind": {
            "enum": [
              "land",
              "realty",
              "vehicle"
            ],
            "type": "string"
          },
          "present": {
            "type": "boolean"
          },
          "total_sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "kind",
          "present",
          "total_sum",
          "by_year"
        ],
        "type": "object"
      },
      "PropertyResult": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/PropertyItem"
            },
            "type": "array"
          },
          "present_count": {
            "format": "int64",
            "type": "integer"
          },
          "total_sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "items",
          "present_count",
          "total_sum"
        ],
        "type": "object"
      },
      "PropertyYear": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "sum": {
            "format": "double",
            "type": "number"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "year",
          "sum",
          "count"
        ],
        "type": "object"
      },
      "RelationEdge": {
        "additionalProperties": false,
        "properties": {
          "source_id": {
            "format": "int64",
            "type": "integer"
          },
          "target_id": {
            "format": "int64",
            "type": "integer"
          },
          "type": {
            "type": "string"
          },
          "types": {
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          }
        },
        "required": [
          "source_id",
          "target_id",
          "type"
        ],
        "type": "object"
      },
      "RelationNode": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "registration_number"
        ],
        "type": "object"
      },
      "RelationsResult": {
        "additionalProperties": false,
        "properties": {
          "edges": {
            "items": {
              "$ref": "#/components/schemas/RelationEdge"
            },
            "type": "array"
          },
          "nodes": {
            "items": {
              "$ref": "#/components/schemas/RelationNode"
            },
            "type": "array"
          }
        },
        "required": [
          "edges",
          "nodes"
        ],
        "type": "object"
      },
      "Risk": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "category": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "details": {
            "items": {
              "$ref": "#/components/schemas/RiskDetail"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "severity": {
            "enum": [
              "low",
              "medium",
              "high",
              "critical"
            ],
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "subject_name": {
            "type": "string"
          },
          "subject_type": {
            "enum": [
              "head",
              "founder"
            ],
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "active",
          "category",
          "severity",
          "title"
        ],
        "type": "object"
      },
      "RiskDetail": {
        "additionalProperties": false,
        "properties": {
          "court_decision": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "debt": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "penalty": {
            "type": "string"
          },
          "penny": {
            "description": "Пеня.",
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "start_date": {
            "type": "string"
          },
          "sum": {
            "type": "string"
          },
          "ugd": {
            "description": "Tax office the debt sits with.",
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "RisksResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Risk"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "score": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "RivalsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/DiscoveryItem"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "SearchItem": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "address": {
            "type": "string"
          },
          "address_area": {
            "type": "string"
          },
          "country_code": {
            "type": "string"
          },
          "employee_count": {
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "description": "Country-specific fields (e.g. KZ kato, kse, kfc).",
            "type": "object"
          },
          "head": {
            "type": "string"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "industry_code": {
            "type": "string"
          },
          "industry_name": {
            "type": "string"
          },
          "legal_form": {
            "description": "Canonical legal form (\"sole_trader\" / \"legal_entity\").",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "registration_date": {
            "format": "date-time",
            "type": "string"
          },
          "registration_number": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "status_code": {
            "description": "Normalized status code — map to a label, do not display raw. active | dormant. NOTE: unlike the company card this never reports \"liquidated\": tax-authority liquidation is not indexed, so list views cannot see it.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "country_code",
          "registration_number",
          "name"
        ],
        "type": "object"
      },
      "SearchResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/SearchItem"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "Stats": {
        "additionalProperties": false,
        "properties": {
          "companies": {
            "format": "int64",
            "type": "integer"
          },
          "jurisdictions": {
            "format": "int64",
            "type": "integer"
          },
          "risk_checks": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "companies",
          "jurisdictions",
          "risk_checks"
        ],
        "type": "object"
      },
      "TaxMetaByCategory": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "code",
          "count",
          "name",
          "sum"
        ],
        "type": "object"
      },
      "TaxMetaByMonth": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "month": {
            "format": "int64",
            "type": "integer"
          },
          "sum": {
            "format": "double",
            "type": "number"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "count",
          "month",
          "sum",
          "year"
        ],
        "type": "object"
      },
      "TaxMetaByStatus": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "pay_status": {
            "type": "string"
          },
          "sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "count",
          "pay_status",
          "sum"
        ],
        "type": "object"
      },
      "TaxMetaByType": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "name_kz": {
            "type": "string"
          },
          "sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "code",
          "name",
          "sum",
          "count"
        ],
        "type": "object"
      },
      "TaxMetaByYear": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "sum": {
            "format": "double",
            "type": "number"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "count",
          "sum",
          "year"
        ],
        "type": "object"
      },
      "TaxPayment": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "format": "double",
            "type": "number"
          },
          "category": {
            "type": "string"
          },
          "category_id": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "date": {
            "format": "date-time",
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "type": "object"
          },
          "status": {
            "type": "string"
          },
          "tax_authority": {
            "type": "string"
          },
          "tax_authority_code": {
            "type": "string"
          }
        },
        "required": [
          "amount",
          "currency",
          "date"
        ],
        "type": "object"
      },
      "TaxPaymentsMeta": {
        "additionalProperties": false,
        "properties": {
          "by_category": {
            "items": {
              "$ref": "#/components/schemas/TaxMetaByCategory"
            },
            "type": "array"
          },
          "by_month": {
            "items": {
              "$ref": "#/components/schemas/TaxMetaByMonth"
            },
            "type": "array"
          },
          "by_status": {
            "items": {
              "$ref": "#/components/schemas/TaxMetaByStatus"
            },
            "type": "array"
          },
          "by_type": {
            "items": {
              "$ref": "#/components/schemas/TaxMetaByType"
            },
            "type": "array"
          },
          "by_year": {
            "items": {
              "$ref": "#/components/schemas/TaxMetaByYear"
            },
            "type": "array"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          },
          "total_sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "by_category",
          "by_type",
          "by_month",
          "by_status",
          "by_year",
          "total_count",
          "total_sum"
        ],
        "type": "object"
      },
      "TaxPaymentsResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/TaxPayment"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "TaxSummary": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "fine": {
            "format": "double",
            "type": "number"
          },
          "penalty": {
            "format": "double",
            "type": "number"
          },
          "total": {
            "format": "double",
            "type": "number"
          },
          "vat_refund": {
            "format": "double",
            "type": "number"
          },
          "year": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "currency",
          "total",
          "penalty",
          "fine",
          "vat_refund",
          "year"
        ],
        "type": "object"
      },
      "TaxSummaryResult": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/TaxSummary"
            },
            "type": "array"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "page",
          "per_page",
          "total_count"
        ],
        "type": "object"
      },
      "TenderItem": {
        "additionalProperties": false,
        "properties": {
          "count_lots": {
            "format": "int64",
            "type": "integer"
          },
          "end_date": {
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "description": "Country-specific fields (KZ goszakup ad ID, ref-table FKs, KATO, localized names).",
            "type": "object"
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "last_update_date": {
            "type": "string"
          },
          "method": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organizer_name": {
            "type": "string"
          },
          "organizer_registration_number": {
            "type": "string"
          },
          "publish_date": {
            "type": "string"
          },
          "start_date": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "supplier_registration_number": {
            "description": "Set after the tender is awarded; absent for in-progress tenders.",
            "type": "string"
          },
          "total_sum": {
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "id",
          "name",
          "total_sum",
          "count_lots",
          "method",
          "status",
          "start_date",
          "end_date",
          "publish_date",
          "last_update_date",
          "organizer_name",
          "organizer_registration_number"
        ],
        "type": "object"
      },
      "TenderSearchRequest": {
        "additionalProperties": false,
        "properties": {
          "end_date": {
            "type": "string"
          },
          "extra": {
            "additionalProperties": {},
            "description": "Country-specific filters (KZ goszakup internals — kato, fin_year, name_kz, ref IDs).",
            "type": "object"
          },
          "last_id": {
            "description": "Keyset pagination cursor — the last_id returned by the previous page.",
            "format": "int64",
            "type": "integer"
          },
          "organizer_name": {
            "type": "string"
          },
          "organizer_registration_number": {
            "description": "Country-specific company identifier of the tender organizer (e.g. KZ BIN).",
            "type": "string"
          },
          "page": {
            "format": "int64",
            "type": "integer"
          },
          "per_page": {
            "format": "int64",
            "type": "integer"
          },
          "query": {
            "type": "string"
          },
          "start_date": {
            "type": "string"
          },
          "status": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "sum_from": {
            "format": "double",
            "type": "number"
          },
          "sum_to": {
            "format": "double",
            "type": "number"
          },
          "trade_methods": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "TenderSearchResult": {
        "additionalProperties": false,
        "properties": {
          "has_next": {
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/TenderItem"
            },
            "type": "array"
          },
          "last_id": {
            "description": "Keyset pagination cursor — pass back as the request's last_id to fetch the next page.",
            "format": "int64",
            "type": "integer"
          },
          "total_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total_count",
          "has_next"
        ],
        "type": "object"
      }
    }
  },
  "info": {
    "title": "pulsar",
    "version": "0.1.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/v2/batches": {
      "get": {
        "operationId": "get-batch-list-global",
        "parameters": [
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchListGlobalResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "List batch jobs (all countries)",
        "tags": [
          "batch"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/alternatives": {
      "get": {
        "operationId": "get-alternatives",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "registration_number",
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "industry_code",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlternativesResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get alternative companies",
        "tags": [
          "search"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/batches": {
      "get": {
        "operationId": "get-batch-list",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchListResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "List batch jobs",
        "tags": [
          "batch"
        ],
        "x-public": true
      },
      "post": {
        "operationId": "post-batch",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchJob"
                }
              }
            },
            "description": "Created"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Create a batch verification job",
        "tags": [
          "batch"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/batches/{id}": {
      "get": {
        "operationId": "get-batch-status",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchJob"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get batch job status",
        "tags": [
          "batch"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/batches/{id}/results": {
      "get": {
        "operationId": "get-batch-results",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchResultsResponse"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get batch job results",
        "tags": [
          "batch"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/catalog": {
      "get": {
        "operationId": "get-catalog",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "area",
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "industry_code",
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Browse company catalog",
        "tags": [
          "search"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}": {
      "get": {
        "operationId": "get-company",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanyCard"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company data by ID",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/access": {
      "get": {
        "operationId": "get-company-access",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccessInfo"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Check the user's paid access to a company without spending a check",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/accounting": {
      "get": {
        "operationId": "get-company-accounting",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountingReport"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company accounting report",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/accreditations": {
      "get": {
        "operationId": "get-company-accreditations",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccreditationsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company accreditations / program memberships",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/affiliations": {
      "get": {
        "operationId": "get-company-affiliations",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "direction",
            "schema": {
              "default": "all",
              "enum": [
                "up",
                "down",
                "all"
              ],
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 20,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AffiliationsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company affiliations",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/arrests": {
      "get": {
        "operationId": "get-arrests",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArrestsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company financial arrests",
        "tags": [
          "compliance"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/bank-accounts": {
      "get": {
        "operationId": "get-bank-accounts",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccountsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company bank accounts",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/branches": {
      "get": {
        "operationId": "get-company-branches",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BranchesResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company branches",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/certificates": {
      "get": {
        "operationId": "get-certificates",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "type",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificatesResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company certificates",
        "tags": [
          "certificates"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/certificates/meta": {
      "get": {
        "operationId": "get-certificates-meta",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificatesMeta"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get certificates statistics",
        "tags": [
          "certificates"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/contacts": {
      "get": {
        "operationId": "get-company-contacts",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company contact information",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/contracts": {
      "get": {
        "operationId": "get-contracts",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContractsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company procurement contracts",
        "tags": [
          "procurement"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/contracts/by-year": {
      "get": {
        "operationId": "get-contracts-by-year",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContractsByYear"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get contracts aggregated by calendar year (supplier and customer)",
        "tags": [
          "procurement"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/contracts/meta": {
      "get": {
        "operationId": "get-contracts-meta",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContractsMeta"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get contracts statistics",
        "tags": [
          "procurement"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/court-cases": {
      "get": {
        "operationId": "get-court-cases",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "status",
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "role",
            "schema": {
              "enum": [
                "plaintiff",
                "defendant"
              ],
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "year_from",
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "year_to",
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourtCasesResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company court cases",
        "tags": [
          "compliance"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/court-cases/meta": {
      "get": {
        "operationId": "get-court-cases-meta",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourtCasesMeta"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get court cases statistics",
        "tags": [
          "compliance"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/court-cases/status": {
      "get": {
        "operationId": "get-court-cases-status",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourtWorkerStatus"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get court cases worker status",
        "tags": [
          "compliance"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/employees": {
      "get": {
        "operationId": "get-company-employees",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmployeesInfo"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company employees",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/events": {
      "get": {
        "operationId": "get-company-events",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 20,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company events",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/events/meta": {
      "get": {
        "operationId": "get-company-events-meta",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsMeta"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get aggregated change-history metadata",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/finances": {
      "get": {
        "operationId": "get-company-finances",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FinancesResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company financial reports",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/founders": {
      "get": {
        "operationId": "get-company-founders",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FoundersResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company founders/shareholders",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/head-participation": {
      "get": {
        "operationId": "get-company-head-participation",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HeadParticipationResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get the head's participation in other legal entities",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/licenses": {
      "get": {
        "operationId": "get-licenses",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicensesResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company licenses",
        "tags": [
          "certificates"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/news": {
      "get": {
        "operationId": "get-company-news",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NewsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company news",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/property": {
      "get": {
        "operationId": "get-company-property",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PropertyResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company property profile (land / real estate / vehicles)",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/relations": {
      "get": {
        "operationId": "get-company-relations",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RelationsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company relations graph",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/risks": {
      "get": {
        "operationId": "get-risks",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RisksResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company risk profile",
        "tags": [
          "compliance"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/rivals": {
      "get": {
        "operationId": "get-company-rivals",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RivalsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company rivals",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/tax/estimated-profit": {
      "get": {
        "description": "An ESTIMATE derived by inverting corporate income tax (tax / rate), not a reported figure and not revenue. Empty means it cannot be estimated for this company — never that the profit was zero. Paid access only.",
        "operationId": "get-estimated-profit",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EstimatedProfitResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get taxable profit estimated from corporate income tax",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/tax/payments": {
      "get": {
        "operationId": "get-tax-payments",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "sort_by",
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "sort_order",
            "schema": {
              "enum": [
                "asc",
                "desc"
              ],
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "year_from",
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "year_to",
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "description": "Budget-classification code — return only payments under this code",
            "explode": false,
            "in": "query",
            "name": "kbk",
            "schema": {
              "description": "Budget-classification code — return only payments under this code",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaxPaymentsResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company tax payments",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/tax/payments/meta": {
      "get": {
        "operationId": "get-tax-payments-meta",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaxPaymentsMeta"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get aggregated tax payment metadata",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/companies/{id}/tax/summary": {
      "get": {
        "operationId": "get-tax-summary",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaxSummaryResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get company tax summary",
        "tags": [
          "tax"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/features": {
      "get": {
        "operationId": "get-features",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Features"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Get available features for the country",
        "tags": [
          "meta"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/info": {
      "get": {
        "operationId": "get-info",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CountryInfo"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Static country metadata with per-region company counts",
        "tags": [
          "search"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/search": {
      "get": {
        "operationId": "search-companies",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "q",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "page",
            "schema": {
              "default": 1,
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "explode": false,
            "in": "query",
            "name": "per_page",
            "schema": {
              "default": 50,
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Search companies",
        "tags": [
          "search"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/search/advanced": {
      "post": {
        "operationId": "search-advanced",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdvancedSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Advanced company search",
        "tags": [
          "search"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/stats": {
      "get": {
        "operationId": "get-stats",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Stats"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Public coverage stats for the landing page",
        "tags": [
          "company"
        ],
        "x-public": true
      }
    },
    "/api/v2/{country}/tenders/search": {
      "post": {
        "operationId": "post-tender-search",
        "parameters": [
          {
            "in": "path",
            "name": "country",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TenderSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TenderSearchResult"
                }
              }
            },
            "description": "OK"
          },
          "default": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Search tenders",
        "tags": [
          "tender"
        ],
        "x-public": true
      }
    }
  }
}