{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kokofinance-net/json-schema/kokofinance-net-v1-card-search-request-schema.json",
  "title": "V1CardSearchRequest",
  "description": "Request for POST /search",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kokofinance-net-openapi.json#/components/schemas/V1CardSearchRequest",
  "properties": {
    "card_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Card Type",
      "description": "Card type filter: travel, cashback, balance_transfer, business, student, hotel, airline"
    },
    "max_annual_fee": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Annual Fee",
      "description": "Maximum annual fee in dollars (e.g. 200). Omit for no limit."
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Issuer",
      "description": "Filter by issuer (e.g. 'Chase', 'American Express', 'Capital One')"
    },
    "spending": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Spending",
      "description": "Monthly spending by category for ranking (e.g. {\"dining\": 500, \"travel\": 300})"
    },
    "max_results": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 20.0,
          "minimum": 1.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Results",
      "description": "Maximum number of results (1-20, default 5)",
      "default": 5
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Country",
      "description": "ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB'). Defaults to 'US'."
    }
  },
  "type": "object"
}