SearchRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/g62-ai/json-schema/g62-ai-search-request-schema.json",
  "title": "SearchRequest",
  "x-generated": "2026-11-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/g62-ai-openapi.json#/components/schemas/SearchRequest",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "mode",
    "text",
    "publicInformation"
  ],
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "patent",
        "text",
        "figure"
      ]
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2500,
      "description": "US/EP publication number for patent mode, otherwise a public search description."
    },
    "cutoff": {
      "type": "string",
      "description": "YYYY-MM-DD, none, or auto for patent mode."
    },
    "office": {
      "type": "string",
      "enum": [
        "US",
        "EP",
        "all"
      ],
      "default": "all"
    },
    "k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 100
    },
    "claim": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "maximum": 100
    },
    "publicInformation": {
      "type": "boolean",
      "const": true,
      "description": "Must be true only when the user authorizes searching public patent information."
    }
  }
}