Commission Tool

get_agent_offers

Get exclusive offers available for your registered agent. Returns active campaigns with bonus commission rates and customer discount information.

Parameters

Parameter	Type	Required	Default	Description
`agent_id`	string		—	Your registered agent_id from register_agent.

Response

Returns an array of offer objects representing active campaigns available to the agent.

Field	Type	Description
`campaign_name`	string	Campaign display name.
`bonus_rate`	number	Bonus commission rate stacked on top of the default rate (e.g., 0.05 = +5%).
`customer_discount_percent`	number \| null	Customer-facing discount percentage, or `null` if the campaign has no customer discount.
`customer_discount_code`	string \| null	Generic campaign discount code, or `null`.
`ends_at`	string	Campaign end date in ISO 8601 format.

Response

[
  {
    "campaign_name": "Spring Sale",
    "bonus_rate": 0.05,
    "customer_discount_percent": 10.0,
    "customer_discount_code": "SPRING10",
    "ends_at": "2026-03-31T23:59:59+00:00"
  },
  {
    "campaign_name": "New Agent Welcome",
    "bonus_rate": 0.03,
    "customer_discount_percent": null,
    "customer_discount_code": null,
    "ends_at": "2026-12-31T23:59:59+00:00"
  }
]

Notes

Agent-specific discount codes

This tool returns generic campaign information. To get a unique, trackable discount code attributed to your agent, use get_my_discount_code with a specific campaign ID. Agent discount codes enable commission tracking on sales.

Tool visibility

This tool may not be available on all stores. Merchants can toggle tool visibility in the brand console. If you receive a "tool not found" error, the merchant may have disabled this tool.

Errors

Error	Cause	Resolution
`{"error": "Agent not registered..."}`	The provided `agent_id` is not registered with this store.	Call register_agent first to get a valid agent_id.

Error response

[
  {
    "error": "Agent not registered. Call register_agent first."
  }
]