{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/legaldatahunter-com/json-schema/legaldatahunter-com-resolve-request-schema.json",
  "title": "ResolveRequest",
  "x-generated": "2026-11-15",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/legaldatahunter-com-openapi.json#/components/schemas/ResolveRequest",
  "properties": {
    "reference": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "title": "Reference",
      "description": "Legal reference to resolve (e.g., 'art. 6 code civil')"
    },
    "hint_country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Hint Country",
      "description": "LDH jurisdiction code — mostly ISO 3166-1 alpha-2, plus aggregate/supranational codes (e.g. 'FR', 'DE', 'BG'; 'EU' for EU law, 'CoE' for ECtHR, 'INTL' for international courts, also 'UN', 'OECD'). Call discover_countries for the full list. STRONGLY RECOMMENDED: roughly doubles the resolution rate (~65% vs ~31%) by scoping ambiguous citations to the right one of 230+ jurisdictions. Pass it whenever the jurisdiction is known."
    },
    "hint_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Hint Type",
      "description": "Type hint: 'legislation' or 'case_law'. Recommended — further narrows resolution."
    }
  },
  "type": "object",
  "required": [
    "reference"
  ]
}