List the offers one customer may take
list_offers_for_customerRetrieve the offers a customer can take now, accounting for existing subscriptions, and optionally show upgrade or downgrade options for a running subscription.
Instructions
Lists the ProAbono offers a named customer may take right now, which is not the same set as the catalogue: it accounts for what they already hold. Read-only. Set upgrade_only, with the subscription's identifier when the customer holds several, to get the upgrade and downgrade options of a running subscription -- the answer to "what can this customer move to?", which list_offers cannot give. Use list_offers for the public catalogue. Reads every page.
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": {
"customer_ref": "<customer_ref>"
},
"name": "list_offers_for_customer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customer_ref | Yes | Shared reference of the customer. | |
| upgrade_only | No | Only the offers the customer's current subscription can move to. | |
| visible_only | No | Only offers marked visible. | |
| subscription_id | No | Which subscription the upgrade options are for, when the customer has several. |