Commission Tool

get_active_campaigns

Discover currently active commission campaigns. Campaigns may include bonus commission rates for agents and discount codes for customers.

Parameters

This tool takes no parameters.

Response

Returns an array of active campaign objects. An empty array means no campaigns are currently running.

Field	Type	Description
`name`	string	Campaign display name.
`bonus_rate`	number	Additional commission rate on top of the default rate (e.g., 0.05 = +5%).
`customer_discount_percent`	number \| null	Percentage discount for customers using a campaign code. `null` if the campaign has no customer discount.
`customer_discount_code`	string \| null	Generic campaign discount code. `null` if no customer discount is configured.
`starts_at`	string	Campaign start date in ISO 8601 format.
`ends_at`	string	Campaign end date in ISO 8601 format.

Response

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

No Active Campaigns

When no campaigns are currently running, the response is an empty array. The store's default commission rate still applies.

Response

[]

Notes

Effective commission rate

Your effective commission rate for a sale is: default_rate + bonus_rate. For example, an 8% default rate with a 5% campaign bonus gives you a 13% effective rate. The rate is locked at the time the order is placed.

Campaign vs. agent discount codes

The customer_discount_code shown here is the generic campaign code. To get a unique, agent-attributed discount code, use get_my_discount_code instead. Agent discount codes track sales back to your agent for commission attribution.

Errors

This tool returns an empty array on store lookup failures rather than an error object. If you consistently receive an empty array for a store that should have campaigns, verify the store public ID in the endpoint URL.