> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Commission Rates
> Retrieve a paginated list of commission rates.
Returns commission rates with their rules and currency-specific values.
`scope_type` is a virtual filter derived from each rate's rules — it is not a
stored column. Use it to filter rates by the scope their rules target.
## Query parameters
Maximum number of records to return.
Number of records to skip.
Field to sort by, prefix with `-` for descending order.
Comma-separated fields to include in the response.
Search term matched against commission rates.
Filter by commission rate ID(s).
Filter by commission rate code(s).
Filter by rate type: `fixed` or `percentage`.
Filter by rule scope: `store`, `product_type`, `category`, `store_product_type`, or `store_category`.
Filter by enabled state.
Filter by whether the rate is the marketplace default.
Filter by creation date using operators like `$gte` and `$lte`.
Filter by update date using operators like `$gte` and `$lte`.
## Response
The commission rate's ID.
The rate's display name.
The rate's unique code.
The rate type: `fixed` or `percentage`.
The commission value — a percentage or a fixed amount.
Currency of a fixed rate's value.
Whether commission is calculated on tax-inclusive amounts.
Whether shipping is included in the commission base.
Whether the rate is active.
Whether this is the marketplace default rate.
Rules scoping the rate, each with `id`, `reference`, and `reference_id`.
Per-currency fixed amounts, each with `id`, `currency_code`, and `amount`.
Creation timestamp.
Last update timestamp.
Total number of matching commission rates.
Number of records skipped.
Maximum number of records returned.
```bash cURL theme={null}
curl 'http://localhost:9000/admin/commission-rates?scope_type=store&limit=20' \
-H 'Authorization: Bearer '
```
```ts JS Client theme={null}
const { commission_rates, count } = await client.admin.commissionRates.query({
scope_type: "store",
limit: 20,
})
```
```json 200 theme={null}
{
"commission_rates": [
{
"id": "comrate_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
"name": "Default",
"code": "default",
"type": "percentage",
"value": 10,
"currency_code": null,
"include_tax": false,
"include_shipping": false,
"is_enabled": true,
"is_default": true,
"rules": [],
"values": []
}
],
"count": 1,
"offset": 0,
"limit": 20
}
```