Keep, downgrade or cancel a card
keep_or_cancelFor cards the person already carries, says whether each one still earns its annual fee back on their spending, and what to move to if not. Pass the cards as held. Returns a verdict and a rounded yearly margin.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| held | No | Card ids the person already carries, so a new card is judged against them. | |
| mode | No | Whether points are valued as cash back or for travel. Defaults to cash. | |
| years | No | Horizon in years. One of 1, 3 or 5; defaults to 5. | |
| source | Yes | A short lowercase slug naming your client, so apply clicks can be attributed. Required. | |
| totals | Yes | A year's card spending in dollars, by category. Map the person's statement onto these categories with the spending_categories tool first. At least 4 categories must have spending and no single one may exceed 70% of the total, so send the whole picture rather than one category. | |
| filters | No | Must-haves that remove cards before ranking. | |
| departures | No | Flights departed per year, which decides what lounge and companion perks are worth. | |
| memberships | No | Membership tags the person already pays for, e.g. amazon_prime, costco_membership. | |
| foreignPerYear | No | Of that spending, how much is in a foreign currency, per year. |