catalog

Find credit cards open to new applicants by issuer, annual fee, network, rewards currency, or a benefit they carry. Returns a short row per card; call get_card_facts for one card's full record. Card facts only — no earning rates, welcome-offer amounts, transfer ratios, or bonus sizes.

{
  "type": "object",
  "properties": {
    "issuer": {
      "type": "string",
      "description": "Exact issuer name.",
      "enum": [
        "American Express",
        "Bank of America",
        "Barclays",
        "BECU",
        "Capital One",
        "Chase",
        "Citi",
        "Column N.A.",
        "Comenity",
        "Discover",
        "Elan Financial Services",
        "Emigrant Bank",
        "First Bank & Trust",
        "First Electronic Bank",
        "FNBO",
        "Goldman Sachs",
        "HSBC",
        "Synchrony",
        "TD Bank",
        "UBS",
        "US Bank",
        "Wells Fargo"
      ]
    },
    "card_type": {
      "type": "string",
      "description": "Personal or Business.",
      "enum": [
        "Business",
        "Personal"
      ]
    },
    "network": {
      "type": "string",
      "description": "Payment network.",
      "enum": [
        "American Express",
        "Discover",
        "Mastercard",
        "Visa"
      ]
    },
    "max_annual_fee": {
      "type": "number",
      "description": "Highest annual fee in dollars, inclusive."
    },
    "no_foreign_transaction_fee": {
      "type": "boolean",
      "description": "Only cards with no foreign transaction fee."
    },
    "rewards_currency": {
      "type": "string",
      "description": "Loyalty currency the card earns, e.g. 'Chase Ultimate Rewards'. Matched loosely."
    },
    "benefit": {
      "type": "string",
      "description": "Words to look for in a card's statement credits, lounge networks, or purchase/travel protections, e.g. 'Global Entry', 'Priority Pass', 'trip delay'."
    },
    "has_lounge_access": {
      "type": "boolean",
      "description": "Only cards carrying at least one lounge network."
    },
    "has_free_night_certificate": {
      "type": "boolean",
      "description": "Only cards granting a free night certificate."
    },
    "limit": {
      "type": "number",
      "description": "Rows to return. Default 10, maximum 25."
    }
  },
  "additionalProperties": false
}

Everything the public catalog holds on one card: issuer, annual fee, network, foreign transaction fee, rewards currency, and the names of its statement credits, lounge networks and protections. Card name is matched loosely. Card facts only — no earning rates, welcome-offer amounts, transfer ratios, or bonus sizes.

{
  "type": "object",
  "properties": {
    "card_name": {
      "type": "string",
      "description": "Card name, e.g. 'Amex Platinum' or 'Venture X'."
    }
  },
  "required": [
    "card_name"
  ],
  "additionalProperties": false
}

The same catalog record for 2-5 cards at once, for comparing fees, networks and which benefits each carries. Card facts only — no earning rates, welcome-offer amounts, transfer ratios, or bonus sizes.

{
  "type": "object",
  "properties": {
    "card_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 5,
      "description": "Card names, matched loosely."
    }
  },
  "required": [
    "card_names"
  ],
  "additionalProperties": false
}

Which loyalty programs a currency transfers to, or which currencies reach a destination, and whether a transfer bonus is running. This is the route graph only — it does not carry transfer ratios, bonus sizes, expiry dates, or which route is worth taking. Card facts only — no earning rates, welcome-offer amounts, transfer ratios, or bonus sizes.

{
  "type": "object",
  "properties": {
    "from_program": {
      "type": "string",
      "description": "Source currency, e.g. 'Chase Ultimate Rewards'.",
      "enum": [
        "Aer Lingus AerClub",
        "American Express Membership Rewards",
        "Bilt Rewards",
        "British Airways Club",
        "Capital One Miles",
        "Chase Ultimate Rewards",
        "Choice Privileges",
        "Citi ThankYou Rewards",
        "Club Iberia Plus",
        "Finnair Plus",
        "HSBC Rewards Points",
        "Loganair Loyalty",
        "Marriott Bonvoy",
        "Qatar Airways Privilege Club",
        "Rove Miles",
        "US Bank Altitude Points",
        "Virgin Atlantic Flying Club",
        "Virgin Red",
        "Wells Fargo Rewards"
      ]
    },
    "to_program": {
      "type": "string",
      "description": "Destination program, e.g. 'World of Hyatt'. Matched loosely; call with neither argument to list every source."
    },
    "only_with_bonus": {
      "type": "boolean",
      "description": "Only routes with a transfer bonus running."
    },
    "include_inactive": {
      "type": "boolean",
      "description": "Include routes that have been discontinued."
    },
    "limit": {
      "type": "number",
      "description": "Routes to return. Default 100, maximum 200."
    }
  },
  "additionalProperties": false
}

Miles' own estimate of a loyalty point's value in cents, optionally multiplied by a balance. Call with no arguments to list every program Miles values, with the exact spelling to use. These are Miles' estimates, not market prices — attribute them. Card facts only — no earning rates, welcome-offer amounts, transfer ratios, or bonus sizes.

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Loyalty program, e.g. 'World of Hyatt'. Matched loosely. Omit to list all."
    },
    "points": {
      "type": "number",
      "description": "A balance to value, in points."
    }
  },
  "additionalProperties": false
}