{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Rate category, e.g. savings, cds, money-market, checking, mortgage."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "category"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "description": "Optional bank name for user-facing context."
    },
    "balance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "currentApy": {
      "type": "number",
      "minimum": 0,
      "maximum": 25
    },
    "balance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "required": [
    "currentApy"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "indexId": {
      "type": "string",
      "description": "Index id, e.g. bank-gap-index, cd-spread, mma-spread, checking-gap."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "required": [
    "indexId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "description": "Card slug or name, e.g. platinum-card or Chase Sapphire Reserve."
    },
    "segment": {
      "type": "string",
      "description": "Optional segment id, e.g. occasional-traveler, small-business-owner, balance-carrier."
    }
  },
  "required": [
    "card"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "description": "Optional card id (issuer:slug), slug, or name to filter to one card, e.g. chase:sapphire-preferred or Sapphire Preferred."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Optional program id or name to filter routes by source or destination, e.g. chase-ultimate-rewards or Flying Blue."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "sinceDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Only changes observed within this many days."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "description": "Optional reward currency id or name, e.g. chase-ultimate-rewards or Membership Rewards."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 25,
      "description": "Card ids the user holds, in the form issuer:slug, e.g. [\"chase:sapphire-preferred\", \"amex:gold-card\"]."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dining",
          "rideshare",
          "travel",
          "lounge",
          "entertainment",
          "insurance",
          "groceries",
          "gas",
          "other"
        ]
      },
      "description": "Optional spend categories to rank held cards for; defaults to all nine."
    },
    "usedBenefits": {
      "type": "array",
      "maxItems": 200,
      "items": {
        "type": "object",
        "properties": {
          "cardId": {
            "type": "string"
          },
          "benefitKey": {
            "type": "string"
          },
          "periodStart": {
            "type": "string",
            "description": "ISO first-of-month key for the period the credit was used in, e.g. 2026-09-01T00:00:00.000Z."
          }
        },
        "required": [
          "cardId",
          "benefitKey",
          "periodStart"
        ],
        "additionalProperties": false
      },
      "description": "Optional log of period credits already used this month; excluded from picks and counted toward renewal value. Omit to treat every credit as unused."
    },
    "savingsBalance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Optional cash balance, to include the savings-rate move beside the card moves."
    },
    "currentSavingsApy": {
      "type": "number",
      "minimum": 0,
      "maximum": 25,
      "description": "Optional current savings APY, used with savingsBalance."
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "institutionId": {
      "type": "string",
      "description": "Optional institution_registry id, e.g. chase, american-express, wells-fargo. Omit to return every bank SwitchWize has verified."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string",
      "description": "Optional card id (issuer:slug), e.g. chase:sapphire-reserve or capital-one:venture-x-rewards. Omit to return every verified downgrade path and fee-refund window."
    }
  },
  "additionalProperties": false
}