List partner groups

GET /program/affiliates/groups

Scope	program:read
Customer session token	Not accepted: call from your server with an API key
Rate limit class	read (limits)
Idempotency key	Not used
MCP tool	charm_list_affiliate_groups

Partner groups with their own commission and buyer discount, and how many partners are in each.

Response 200

Returns AffiliateGroupList.

Field	Type	Description
data	array of AffiliateGroup

{
  "data": [
    {
      "id": "id",
      "name": "Gold",
      "commission": {
        "type": null,
        "code_rate": null,
        "link_rate": null
      },
      "customer_discount": {
        "type": null,
        "value": null
      },
      "member_count": 1
    }
  ]
}

Example

curl -X GET "https://charm.appfleece.app/api/v1/program/affiliates/groups" \
  -H "Authorization: Bearer chrm_live_..."

Errors

unauthorized · invalid_token · insufficient_scope · access_required · validation_error · rate_limited

Every error body carries code, message, request_id and a doc_url pointing at the matching entry in the error catalog.