Best redemption path
best_redemptionFor ONE of the signed-in user's points programs: the estimated value of their balance and the valuation basis behind it, the program type, its transfer partners with current ratios and whether PointBagel has verified a route out, published transfer times, the sweet-spot awards worth aiming for, the kind of price each carries, how far the balance goes toward each, where to confirm each award (plain links), any transfer-bonus cap in the issuer's units, and which card would unlock full transfer access. Point values are estimates, not promises. Does NOT check live award availability; for open award seats use point.me, Seats.aero, or the airline. Read-only; the user's own balances only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"program": "<program>"
},
"name": "best_redemption"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters | No | Optional filters that narrow PointBagel's catalogued award sweet spots: destination region, cabin, trip type, and the most points the user wants to spend on one award, in this program's own points. round_trip keeps one-way awards, since a round trip is two of them; one_way leaves out awards priced as a round trip. An award whose price can run above the points cap is left out. They do not check whether award seats or rooms are available. | |
| program | Yes | A points program name or id, e.g. "Chase Ultimate Rewards" or "amex_mr". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | ||
| data | Yes | ||
| status | Yes | ||
| summary | Yes | ||
| nextActions | No | ||
| userWarnings | No |