> ## 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.

# Retrieve MCC group

> Use this endpoint to retrieve a specific MCC group.

GET/mccgroups/\{token}

Use this endpoint to retrieve a specific MCC group.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the MCC group. **Allowable Values:** |

## Response body

| Fields | Description |
| - | - |
| active boolean  Conditionally returned | Indicates if the group is active or inactive. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| 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` |
| 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 impact 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` |
| 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 |
| 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` |
| 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` |
| 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 |
| 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 |
| name string  Returned | Name of the MCC group. **Allowable Values:**  255 char max |
| 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 |

## Sample response body

```json JSON lines wrap theme={null}
{
  "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
    }
  }
}
```


## 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)
- [Update authorization control](https://www.marqeta.com/docs/core-api/authorization-controls/update-authorization-control.md)
- [Create velocity control](https://www.marqeta.com/docs/core-api/velocity-controls/create-velocity-control.md)
- [Returns a specific velocity control](https://www.marqeta.com/docs/core-api/velocity-controls/returns-specific.md)