Welcome offer and bonus progress
welcome_offerWelcome-offer coverage for one credit card: the current published offer (bonus, minimum spend, time window, and when PointBagel verified it), how the offer is available (public, through the application flow, targeted or variable, by referral, no public offer, or not recently verified), a verified finding when a card has no public offer, and, for a card the user owns, their estimated progress toward the bonus from imported transactions. Use it to judge how strong an offer is and whether to apply now or wait. Estimates, not guarantees. Read-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": {
"card": "<card>"
},
"name": "welcome_offer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card | Yes | A card name or id, e.g. "Marriott Bonvoy Brilliant" or "chase_sapphire_preferred". | |
| includeApplyLink | No | Set to true when the user is asking about applying for this card. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | ||
| data | Yes | ||
| status | Yes | ||
| summary | Yes | ||
| nextActions | No | ||
| userWarnings | No |