> ## 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 Commando Mode control sets

> Retrieve a list of Commando Mode control sets.

GET/commandomodes

Retrieve a list of Commando Mode control sets.

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 |
| - | - |
| count integer  Optional | Number of Commando Mode control sets to retrieve. **Allowable Values:**  1-10 **Default value:** 5 |
| 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 Commando Mode control sets 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 Commando Mode control set objects. Objects are returned as appropriate to your query. **Allowable Values:**  Valid array of one or more Commando Mode control set objects |
| data\[].**commando\_mode\_enables** object  Conditionally returned | Defines program behavior when Commando Mode is enabled. **Allowable Values:**  Existing `commando_mode_enables` object |
| data\[].commando\_mode\_enables.**auth\_controls** array of strings  Conditionally returned | Unique identifiers of the authorization controls enabled while in Commando Mode. **Allowable Values:**  Valid array of one or more existing authorization control tokens |
| data\[].commando\_mode\_enables.**ignore\_card\_suspended\_state** boolean  Conditionally returned | If set to `true`, transactions conducted while Commando Mode is enabled proceed even when the card is suspended. If set to `false`, transactions conducted while Commando Mode is enabled are declined if the card is suspended. **Allowable Values:**  `true`, `false` |
| data\[].commando\_mode\_enables.**program\_funding\_source** string  Returned | Unique identifier of the program funding source that substitutes for the program gateway funding source upon Commando Mode enablement. **Allowable Values:**  36 char max |
| data\[].commando\_mode\_enables.**use\_cache\_balance** boolean  Conditionally returned | This field is not currently in use. **Allowable Values:**  N/A |
| data\[].commando\_mode\_enables.**velocity\_controls** array of strings  Conditionally returned | Unique identifiers of the velocity controls enabled while in Commando Mode. Velocity controls that are enabled in Commando Mode are inactive until a Commando Mode event occurs. When Commando Mode velocity controls are activated, they conform to the `velocity_window` specified in that velocity control. For example, a `velocity_window` of `DAY` is one calendar day starting at 00:00:00 UTC. If a Commando Mode event occurs at 11:59:59 UTC, the `DAY` window includes all transactions that occurred between 00:00:00 and 11:59:59 on that calendar day. **Allowable Values:**  One or more existing velocity control tokens |
| data\[].**created\_time** datetime  Returned | Date and time when the resource was created, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**current\_state** object  Conditionally returned | Describes the Commando Mode control set's `current_state` object. **Allowable Values:**  Existing `current_state` object |
| data\[].current\_state.**channel** string  Returned | Mechanism that changed the Commando Mode control set's state. **Allowable Values:**  `API`, `SYSTEM` |
| data\[].current\_state.**commando\_enabled** boolean  Returned | Indicates whether Commando Mode is enabled. - If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode. - If `commando_enabled` is `true` and `COMMANDO_AUTO` is configured, Commando Mode is ready to intervene only when a transaction times out or encounters an error. **Allowable Values:**  `true`, `false` |
| data\[].current\_state.**reason** string  Conditionally returned | Describes the reason why the current state of the Commando Mode control set was last changed. **Allowable Values:**  255 char max |
| data\[].current\_state.**username** string  Conditionally returned | Identifies the user who last changed the Commando Mode control set's state. **Allowable Values:**  255 char max |
| data\[].**last\_modified\_time** datetime  Returned | Date and time when the resource was last updated, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**program\_gateway\_funding\_source\_token** string  Conditionally returned | Unique identifier of the associated program gateway funding source. **Allowable Values:**  Existing program gateway funding source token |
| data\[].**real\_time\_standin\_criteria** object  Conditionally returned | Specifies which event types automatically enable Commando Mode. **Allowable Values:**  Existing `real_time_standin_criteria` object |
| data\[].real\_time\_standin\_criteria.**enabled** boolean  Conditionally returned | If set to `true`, Commando Mode is automatically enabled by events defined in the `real_time_standin_criteria` object. If set to `false`, Auto Commando Mode is not enabled. **Allowable Values:**  `true`, `false` |
| data\[].real\_time\_standin\_criteria.**include\_application\_errors** boolean  Conditionally returned | If set to `true`, an application error (any non-connection, non-timeout error) automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. **Allowable Values:**  `true`, `false` |
| data\[].real\_time\_standin\_criteria.**include\_connection\_errors** boolean  Conditionally returned | If set to `true`, a non-timeout connection error automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. **Allowable Values:**  `true`, `false` |
| data\[].real\_time\_standin\_criteria.**include\_response\_timeouts** boolean  Conditionally returned | If set to `true`, a gateway response slower than 3000ms automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. **Allowable Values:**  `true`, `false` |
| data\[].**token** string  Conditionally returned | Unique identifier of the Commando Mode control set. **Allowable Values:**  Existing Commando Mode control set token |
| 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": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "token": "commando_mode_1",
      "program_gateway_funding_source_token": "pgm_gateway_src_1",
      "current_state": {
        "commando_enabled": false,
        "reason": "New Commando Mode created",
        "channel": "SYSTEM"
      },
      "commando_mode_enables": {
        "program_funding_source": "pgm_funding_src_1",
        "velocity_controls": [
          "vel_control_1"
        ]
      },
      "created_time": "2023-02-14T18:48:10Z",
      "last_modified_time": "2023-02-14T18:48:10Z"
    }
  ]
}
```


## Related topics

- [Commando Mode Overview](https://www.marqeta.com/docs/core-api/commando-mode.md)
- [List Commando Mode transitions set](https://www.marqeta.com/docs/core-api/commando-mode/list-transitions-set.md)
- [Create Commando Mode control set](https://www.marqeta.com/docs/core-api/commando-mode-addendum/create-control-set.md)
- [Update Commando Mode control set](https://www.marqeta.com/docs/core-api/commando-mode-addendum/update-control-set.md)
- [Retrieve Commando Mode control set](https://www.marqeta.com/docs/core-api/commando-mode/retrieve-control-set.md)