> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List MCC groups

> Use this endpoint to either list all MCC groups defined in your program or list all MCC groups that contain a specified code.

GET/mccgroups

Use this endpoint to either list all MCC groups defined in your program or list all MCC groups that contain a specified code.

This endpoint supports [field filtering](https://www.marqeta.com/docs/core-api/field-filtering.md) and [pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md).

## URL query parameters

| Fields | Description |
| - | - |
| mcc string  Optional | Returns all MCC groups that contain the specified merchant category code. **Allowable Values:**  Valid merchant category code |
| count integer  Optional | Number of resources to retrieve. **Allowable Values:**  1-10 |
| start\_index integer  Optional | Sort order index of the first resource in the returned array. **Allowable Values:**  Any integer **Default value:** 0 |
| sort\_by string  Optional | Field on which to sort. Use any field in the resource model, or one of the system fields `lastModifiedTime` or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **Allowable Values:**  `createdTime`, `lastModifiedTime`, or any field in the resource model **Default value:** `-lastModifiedTime` |

## Response body

| Fields | Description |
| - | - |
| count integer  Conditionally returned | Number of resources to retrieve. This field is returned if there are resources in your returned array. **Allowable Values:**  1-10 |
| data array of objects  Conditionally returned | Array of MCC group objects. Objects are returned as appropriate to your query. **Allowable Values:**  Valid array of one or more MCC group objects |
| data\[].**active** boolean  Conditionally returned | Indicates if the group is active or inactive. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| data\[].**config** object  Conditionally returned | Allows for configuration options for this group, including control over the expiration of authorizations and automatic increases to the authorization amount. **Allowable Values:**  `authorization_controls` |
| data\[].config.**authorization\_controls** object  Conditionally returned | Controls the expiration of authorizations and automatic increases to the authorization amount for MCCs specified in this group. By default, these authorization controls apply program-wide, meaning that they apply to every card in your program. You can, however, exempt cards associated with any particular card product by setting that card product's `allow_mcc_group_authorization_controls` field to `false`. **Allowable Values:**  `hold_expiration_days`, `hold_increase` |
| data\[].config.authorization\_controls.**hold\_expiration\_days** integer  Conditionally returned | Specifies the number of days after which an authorization associated with this group expires. **Allowable Values:**  1–100 **Default value:** 7 |
| data\[].config.authorization\_controls.**hold\_increase** object  Conditionally returned | Controls automatic increases to the authorization amount for MCCs specified in this group. **Allowable Values:**  `type`, `value` |
| data\[].config.authorization\_controls.hold\_increase.**type** string  Returned | Controls whether the `value` field represents a fixed amount or a percentage of the authorization amount. **Allowable Values:**  `AMOUNT`, `PERCENT`, `UP_TO_LIMIT` **Default value:** `AMOUNT` |
| data\[].config.authorization\_controls.hold\_increase.**value** decimal  Returned | Specifies the amount of the automatic increase to the authorization amount. The `type` field controls whether this amount is a fixed amount or a percentage. **Allowable Values:**  Format: 0.00 |
| data\[].**mccs** array of objects  Returned | The set of merchant category codes that you want to include in this group. For each element, valid characters are 0-9, and the length must be 4 digits. You can also specify a range such as "9876-9880". An MCC can belong to more than one group. **Allowable Values:**  Existing merchant category codes |
| data\[].**name** string  Returned | Name of the MCC group. **Allowable Values:**  255 char max |
| data\[].**token** string  Conditionally returned | Unique identifier of the MCC group. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. **Allowable Values:**  1–36 chars |
| end\_index integer  Conditionally returned | Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |
| is\_more boolean  Conditionally returned | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist. This field is returned if there are resources in your returned array. **Allowable Values:**  `true`, `false` |
| start\_index integer  Conditionally returned | Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 1,
  "is_more": false,
  "data": [
    {
      "token": "my_mccgroup_02",
      "name": "My MCC Group 02",
      "mccs": [
        "0123",
        "2224-2230"
      ],
      "active": true,
      "config": {
        "authorization_controls": {
          "hold_increase": {
            "type": "AMOUNT",
            "value": 10,
            "hold_expiration_days": 3
          }
        }
      }
    },
    {
      "token": "my_mccgroup_01",
      "name": "My MCC Group 01",
      "mccs": [
        "0123",
        "2224-2230",
        "3876"
      ],
      "active": true,
      "config": {
        "authorization_controls": {
          "hold_increase": {
            "type": "PERCENT",
            "value": 20
          },
          "hold_expiration_days": 2
        }
      }
    }
  ]
}
```


## Related topics

- [MCC Groups Overview](https://www.marqeta.com/docs/core-api/mcc-groups.md)
- [Update MCC group](https://www.marqeta.com/docs/core-api/mcc-groups/update-mcc-group.md)
- [Create MCC group](https://www.marqeta.com/docs/core-api/mcc-groups/create-mcc-group.md)
- [MCC Groups Object](https://www.marqeta.com/docs/core-api/mcc-groups/mcc-groups-object.md)
- [Retrieve MCC group](https://www.marqeta.com/docs/core-api/mcc-groups/retrieve-mcc-group.md)