browse_offers
ChatGPTLists the Ibotta cash back offers available to the user at one retailer, whether or not they have added them. Use this when the user names a store rather than a product — 'what can I save on at Target?'. For a specific product, use find_offers.
clip_offer
ChatGPTClips an offer to the user's Ibotta account so purchases can earn its cash back. Users may call this adding, unlocking or selecting an offer. Call it only after you have shown the offer, once per offer. You MUST NOT clip an offer unless the user has intentionally asked you to clip that one offer. A reply with a condition ("yes if it's still good Saturday"), a request for several offers ("clip everything"), or an unclear answer is not a request: ask again about one offer. If you are not sure, do not clip. Do not press the user to clip, and if they say no, do not offer it again.
find_offers
ChatGPTSearches Ibotta cash back offers for one or more shopping items (product or brand names, or a UPC barcode), optionally within one retailer. Results are grouped per item in relevance order. Sponsored offers are labelled.
get_my_bonuses
ChatGPTLists the Ibotta bonuses the user can work on or has started: what each pays, how far along they are, and when it ends. A bonus pays extra when the user redeems a set of qualifying offers. Read only.
get_my_clipped_offers
ChatGPTLists the offers the user has already clipped to their Ibotta account, optionally only those usable at one retailer.
get_my_earnings
ChatGPTReturns the user's current Ibotta balance, lifetime earnings, and recent earnings lines (receipts, bonuses, withdrawals), newest first. Read only. Amounts are in cents.
get_my_profile
ChatGPTReturns who the user is according to Ibotta: first name, whether email and phone are verified, and which retailers they have linked. Never returns contact details or card numbers.
get_offer
ChatGPTReturns one Ibotta offer with its value, retailers, redemption steps, terms, and whether the user has clipped it.
get_offers_by_category
ChatGPTReturns offers in one Ibotta offer category, in the category's own order, optionally only those usable at one retailer. Category ids come from list_offer_categories. Sponsored offers are labelled.
get_referral_link
ChatGPTReturns the user's personal Ibotta invite link and friend code, plus Ibotta's own invite text. Use it when the user wants to invite a friend. Do not state a reward amount: use only what the invite text says.
list_offer_categories
ChatGPTLists the Ibotta offer categories available to the user, as the Ibotta app shows them. Synthetic categories built for this user, such as For You, What's Hot, Best Value and New Offers, come first, then curated groupings such as product aisles. Buy It Again, built from the user's purchase history, is listed only when the user has shared their history. Only categories that currently have offers are listed. Optionally limit to one retailer.
list_retailers
ChatGPTLists retailers where Ibotta cash back can be earned, with whether the user has linked their account at each and how long cash back stays pending. Linked retailers come first, then the most relevant to the user. Optionally search by name, or limit to retailers the user has linked. Results are paged; pass next_cursor as cursor for more.
show_offer_cards
ChatGPTShows up to 8 offers to the user as cards, each with a button that adds it. Call it with ids from find_offers, browse_offers, get_offers_by_category or get_my_clipped_offers when the user is choosing between offers, or to show one offer you are about to ask about. Do not call it for a lookup the user will not act on.
suggest_offers_for_bonus
ChatGPTLists the offers that count toward one bonus, with the ones the user has not yet clipped first, plus the bonus's progress. Suggests only: it clips nothing. Each offer is clipped separately with clip_offer after the user asks for it.