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

# Commando Mode

> Use the Commando Mode endpoint to view decisioning rules used by the Marqeta platform to respond to Gateway Just-in-Time funding requests when your decisioning system fails.

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-semibold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Commando Mode is a fallback measure that ensures Gateway JIT-funded cards continue to function in the event that your system fails. If your system cannot respond to the JIT Funding request, the Marqeta platform makes a decision in your place based on defined business rules. The Marqeta platform stores any unsent webhooks for later transmission, ensuring that the card state and account balances on your system correspond with activity that occurred while Commando Mode was in effect.

You can identify transactions that were funded while Commando Mode was in effect by examining the `subnetwork` field of the transaction record.

* A `subnetwork` value of `GATEWAY_JIT` indicates that the transaction was funded through normal Gateway JIT Funding and that Commando Mode was not in effect at the time.

* A value of `MANAGED_JIT` indicates that the transaction was funded while Commando Mode was in effect. In addition, the `standin_approved_by` field has a value of `COMMANDO_AUTO` or `COMMANDO_MANUAL` when Commando Mode is enabled for a transaction.

When `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode. When `COMMANDO_AUTO` is configured, Commando Mode is enabled only when a transaction times out or encounters an error.

While Commando Mode is a form of Stand-in Processing (STIP), it is different than network STIP. Network STIP occurs when the card network cannot communicate with the Marqeta platform. Transactions handled by network STIP include the `standin_approved_by` field with a value of `NETWORK`.

Commando Mode and Managed JIT Funding are functionally equivalent. See [About Just-in-Time Funding](/developer-guides/about-jit-funding/) for more information.

<Note>
  **Note**\
  Commando Mode requires additional configuration. To configure Commando Mode control sets, contact your Marqeta representative.
</Note>

<h2 id="get_commandomodes">
  List Commando Mode control sets
</h2>

**Action:** `GET`\
**Endpoint:** `/commandomodes`

{/* <EndpointCard
title="List Commando Mode control sets"
path="/commandomodes"
method="get"
/> */}

Retrieve a list of Commando Mode control sets.

This endpoint supports [field filtering](/core-api/field-filtering/) and [pagination](/core-api/sorting-and-pagination/).

<h3 id="_url_query_parameters">
  URL query parameters
</h3>

| Fields                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Optional        | Number of Commando Mode control sets to retrieve.<br /><br />**Allowable Values:**<br /><br />1-10<br /><br />**Default value:**<br />5                                                                                                                                                                                                                                                                                   |
| start\_index<br /><br />integer<br /><br />Optional | Sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer<br /><br />**Default value:**<br />0                                                                                                                                                                                                                                                                |
| sort\_by<br /><br />string<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`createdTime`, `lastModifiedTime`, or any field in the resource model<br /><br />**Default value:**<br />`-lastModifiedTime` |

<h3 id="_response_body">
  Response body
</h3>

| Fields                                                                                                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| count<br /><br />integer<br /><br />Conditionally returned                                                                  | Number of Commando Mode control sets to retrieve.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />1-10                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| data<br /><br />array of objects<br /><br />Conditionally returned                                                          | Array of Commando Mode control set objects.<br /><br />Objects are returned as appropriate to your query.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more Commando Mode control set objects                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| data\[].**commando\_mode\_enables**<br /><br />object<br /><br />Conditionally returned                                     | Defines program behavior when Commando Mode is enabled.<br /><br />**Allowable Values:**<br /><br />Existing `commando_mode_enables` object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| data\[].commando\_mode\_enables.**auth\_controls**<br /><br />array of strings<br /><br />Conditionally returned            | Unique identifiers of the authorization controls enabled while in Commando Mode.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more existing authorization control tokens                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data\[].commando\_mode\_enables.**ignore\_card\_suspended\_state**<br /><br />boolean<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                             |
| data\[].commando\_mode\_enables.**program\_funding\_source**<br /><br />string<br /><br />Returned                          | Unique identifier of the program funding source that substitutes for the program gateway funding source upon Commando Mode enablement.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| data\[].commando\_mode\_enables.**use\_cache\_balance**<br /><br />boolean<br /><br />Conditionally returned                | This field is not currently in use.<br /><br />**Allowable Values:**<br /><br />N/A                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| data\[].commando\_mode\_enables.**velocity\_controls**<br /><br />array of strings<br /><br />Conditionally returned        | Unique identifiers of the velocity controls enabled while in Commando Mode.<br /><br />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.<br /><br />**Allowable Values:**<br /><br />One or more existing velocity control tokens |
| data\[].**created\_time**<br /><br />datetime<br /><br />Returned                                                           | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data\[].**current\_state**<br /><br />object<br /><br />Conditionally returned                                              | Describes the Commando Mode control set’s `current_state` object.<br /><br />**Allowable Values:**<br /><br />Existing `current_state` object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data\[].current\_state.**channel**<br /><br />string<br /><br />Returned                                                    | Mechanism that changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />`API`, `SYSTEM`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data\[].current\_state.**commando\_enabled**<br /><br />boolean<br /><br />Returned                                         | Indicates whether Commando Mode is enabled.<br /><br />- If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode.<br />- 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.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                      |
| data\[].current\_state.**reason**<br /><br />string<br /><br />Conditionally returned                                       | Describes the reason why the current state of the Commando Mode control set was last changed.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data\[].current\_state.**username**<br /><br />string<br /><br />Conditionally returned                                     | Identifies the user who last changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| data\[].**last\_modified\_time**<br /><br />datetime<br /><br />Returned                                                    | Date and time when the resource was last updated, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| data\[].**program\_gateway\_funding\_source\_token**<br /><br />string<br /><br />Conditionally returned                    | Unique identifier of the associated program gateway funding source.<br /><br />**Allowable Values:**<br /><br />Existing program gateway funding source token                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data\[].**real\_time\_standin\_criteria**<br /><br />object<br /><br />Conditionally returned                               | Specifies which event types automatically enable Commando Mode.<br /><br />**Allowable Values:**<br /><br />Existing `real_time_standin_criteria` object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data\[].real\_time\_standin\_criteria.**enabled**<br /><br />boolean<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data\[].real\_time\_standin\_criteria.**include\_application\_errors**<br /><br />boolean<br /><br />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`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data\[].real\_time\_standin\_criteria.**include\_connection\_errors**<br /><br />boolean<br /><br />Conditionally returned  | If set to `true`, a non-timeout connection error automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| data\[].real\_time\_standin\_criteria.**include\_response\_timeouts**<br /><br />boolean<br /><br />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`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| data\[].**token**<br /><br />string<br /><br />Conditionally returned                                                       | Unique identifier of the Commando Mode control set.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set token                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| end\_index<br /><br />integer<br /><br />Conditionally returned                                                             | Sort order index of the last resource in the returned array.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| is\_more<br /><br />boolean<br /><br />Conditionally returned                                                               | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                     |
| start\_index<br /><br />integer<br /><br />Conditionally returned                                                           | Sort order index of the first resource in the returned array.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

<h3 id="_sample_response_body">
  Sample response body
</h3>

```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"
    }
  ]
}
```

<h2 id="get_commandomodes_token">
  Retrieve Commando Mode control set
</h2>

**Action:** `GET`\
**Endpoint:** `/commandomodes/{token}`

{/* <EndpointCard
title="Retrieve Commando Mode control set"
path="/commandomodes/{token}"
method="get"
/> */}

Retrieve a specific Commando Mode control set.

<h3 id="_url_path_parameters">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                                   |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Unique identifier of the Commando Mode control set you want to retrieve.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set token |

<h3 id="_response_body_2">
  Response body
</h3>

| Fields                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| commando\_mode\_enables<br /><br />object<br /><br />Conditionally returned                                         | Defines program behavior when Commando Mode is enabled.<br /><br />**Allowable Values:**<br /><br />Existing `commando_mode_enables` object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| commando\_mode\_enables.**auth\_controls**<br /><br />array of strings<br /><br />Conditionally returned            | Unique identifiers of the authorization controls enabled while in Commando Mode.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more existing authorization control tokens                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| commando\_mode\_enables.**ignore\_card\_suspended\_state**<br /><br />boolean<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                             |
| commando\_mode\_enables.**program\_funding\_source**<br /><br />string<br /><br />Returned                          | Unique identifier of the program funding source that substitutes for the program gateway funding source upon Commando Mode enablement.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| commando\_mode\_enables.**use\_cache\_balance**<br /><br />boolean<br /><br />Conditionally returned                | This field is not currently in use.<br /><br />**Allowable Values:**<br /><br />N/A                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| commando\_mode\_enables.**velocity\_controls**<br /><br />array of strings<br /><br />Conditionally returned        | Unique identifiers of the velocity controls enabled while in Commando Mode.<br /><br />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.<br /><br />**Allowable Values:**<br /><br />One or more existing velocity control tokens |
| created\_time<br /><br />datetime<br /><br />Returned                                                               | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| current\_state<br /><br />object<br /><br />Conditionally returned                                                  | Describes the Commando Mode control set’s `current_state` object.<br /><br />**Allowable Values:**<br /><br />Existing `current_state` object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| current\_state.**channel**<br /><br />string<br /><br />Returned                                                    | Mechanism that changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />`API`, `SYSTEM`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| current\_state.**commando\_enabled**<br /><br />boolean<br /><br />Returned                                         | Indicates whether Commando Mode is enabled.<br /><br />- If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode.<br />- 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.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                      |
| current\_state.**reason**<br /><br />string<br /><br />Conditionally returned                                       | Describes the reason why the current state of the Commando Mode control set was last changed.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| current\_state.**username**<br /><br />string<br /><br />Conditionally returned                                     | Identifies the user who last changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| last\_modified\_time<br /><br />datetime<br /><br />Returned                                                        | Date and time when the resource was last updated, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| program\_gateway\_funding\_source\_token<br /><br />string<br /><br />Conditionally returned                        | Unique identifier of the associated program gateway funding source.<br /><br />**Allowable Values:**<br /><br />Existing program gateway funding source token                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| real\_time\_standin\_criteria<br /><br />object<br /><br />Conditionally returned                                   | Specifies which event types automatically enable Commando Mode.<br /><br />**Allowable Values:**<br /><br />Existing `real_time_standin_criteria` object                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| real\_time\_standin\_criteria.**enabled**<br /><br />boolean<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| real\_time\_standin\_criteria.**include\_application\_errors**<br /><br />boolean<br /><br />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`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| real\_time\_standin\_criteria.**include\_connection\_errors**<br /><br />boolean<br /><br />Conditionally returned  | If set to `true`, a non-timeout connection error automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| real\_time\_standin\_criteria.**include\_response\_timeouts**<br /><br />boolean<br /><br />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`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| token<br /><br />string<br /><br />Conditionally returned                                                           | Unique identifier of the Commando Mode control set.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set token                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

<h3 id="_sample_response_body_2">
  Sample response body
</h3>

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

<h2 id="get_commandomodes_transitions_token">
  Retrieve Commando Mode transition
</h2>

**Action:** `GET`\
**Endpoint:** `/commandomodes/transitions/{token}`

{/* <EndpointCard
title="Retrieve Commando Mode transition"
path="/commandomodes/transitions/{token}"
method="get"
/> */}

Retrieve a specific Commando Mode control set transition.

<h3 id="_url_path_parameters_2">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                                    |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Unique identifier of the Commando Mode control set transition.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set transition token |

<h3 id="_response_body_3">
  Response body
</h3>

| Fields                                                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| commando\_mode\_token<br /><br />string<br /><br />Conditionally returned   | Unique identifier of the Commando Mode control set.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set token                                                                                                                                                                                                                                                                            |
| created\_time<br /><br />datetime<br /><br />Returned                       | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                                                       |
| name<br /><br />string<br /><br />Conditionally returned                    | Identifies the user who changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                     |
| token<br /><br />string<br /><br />Conditionally returned                   | Unique identifier of the Command Mode control set transition object.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set transition object token                                                                                                                                                                                                                                         |
| transition<br /><br />object<br /><br />Conditionally returned              | Describes the Commando Mode control set’s `current_state` object.<br /><br />**Allowable Values:**<br /><br />Existing `current_state` object                                                                                                                                                                                                                                                                       |
| transition.**channel**<br /><br />string<br /><br />Returned                | Mechanism that changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />`API`, `SYSTEM`                                                                                                                                                                                                                                                                                           |
| transition.**commando\_enabled**<br /><br />boolean<br /><br />Returned     | Indicates whether Commando Mode is enabled.<br /><br />- If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode.<br />- 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.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| transition.**reason**<br /><br />string<br /><br />Conditionally returned   | Describes the reason why the current state of the Commando Mode control set was last changed.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                              |
| transition.**username**<br /><br />string<br /><br />Conditionally returned | Identifies the user who last changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                |
| type<br /><br />string<br /><br />Conditionally returned                    | Specifies the type of event that triggered the Commando Mode transition, such as a `connection_error` or `response_timeout`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                               |

<h3 id="_sample_response_body_3">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "commando_mode_1_transition",
  "commando_mode_token": "commando_mode_1",
  "transition": {
    "commando_enabled": true,
    "reason": "Lost connection",
    "channel": "API",
    "user_name": "rhowse"
  },
  "created_time": "2023-02-14T18:48:10Z"
}
```

<h2 id="get_commandomodes_commandomodetoken_transitions">
  List Commando Mode transitions set
</h2>

**Action:** `GET`\
**Endpoint:** `/commandomodes/{commandomode_token}/transitions`

{/* <EndpointCard
title="List Commando Mode transitions set"
path="/commandomodes/{commandomode_token}/transitions"
method="get"
/> */}

Retrieve a list of Commando Mode transitions for a specific control set.

This endpoint supports [field filtering](/core-api/field-filtering/) and [pagination](/core-api/sorting-and-pagination/).

<h3 id="_url_path_parameters_3">
  URL path parameters
</h3>

| Fields                                                    | Description                                                                                                                              |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| commandomode\_token<br /><br />string<br /><br />Required | Unique identifier of the Commando Mode control set.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set token |

<h3 id="_url_query_parameters_2">
  URL query parameters
</h3>

| Fields                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Optional        | Number of Commando Mode control set transitions to retrieve.<br /><br />**Allowable Values:**<br /><br />1-10<br /><br />**Default value:**<br />5                                                                                                                                                                                                                                                                   |
| start\_index<br /><br />integer<br /><br />Optional | Sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer<br /><br />**Default value:**<br />0                                                                                                                                                                                                                                                           |
| sort\_by<br /><br />string<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`createdTime`, `lastModifiedTime`, or any field in the resource model<br /><br />**Default value:**<br />`-createdTime` |

<h3 id="_response_body_4">
  Response body
</h3>

| Fields                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Conditionally returned                            | Number of Commando Mode control set transition objects to retrieve.<br /><br />**Allowable Values:**<br /><br />1-10                                                                                                                                                                                                                                                                                                |
| data<br /><br />array of objects<br /><br />Conditionally returned                    | Array of Commando Mode control set transition objects.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more Commando Mode control set transition objects                                                                                                                                                                                                                                          |
| data\[].**commando\_mode\_token**<br /><br />string<br /><br />Conditionally returned | Unique identifier of the Commando Mode control set.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set token                                                                                                                                                                                                                                                                            |
| data\[].**created\_time**<br /><br />datetime<br /><br />Returned                     | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                                                       |
| data\[].**name**<br /><br />string<br /><br />Conditionally returned                  | Identifies the user who changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                     |
| data\[].**token**<br /><br />string<br /><br />Conditionally returned                 | Unique identifier of the Command Mode control set transition object.<br /><br />**Allowable Values:**<br /><br />Existing Commando Mode control set transition object token                                                                                                                                                                                                                                         |
| data\[].**transition**<br /><br />object<br /><br />Conditionally returned            | Describes the Commando Mode control set’s `current_state` object.<br /><br />**Allowable Values:**<br /><br />Existing `current_state` object                                                                                                                                                                                                                                                                       |
| data\[].transition.**channel**<br /><br />string<br /><br />Returned                  | Mechanism that changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />`API`, `SYSTEM`                                                                                                                                                                                                                                                                                           |
| data\[].transition.**commando\_enabled**<br /><br />boolean<br /><br />Returned       | Indicates whether Commando Mode is enabled.<br /><br />- If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode.<br />- 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.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| data\[].transition.**reason**<br /><br />string<br /><br />Conditionally returned     | Describes the reason why the current state of the Commando Mode control set was last changed.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                              |
| data\[].transition.**username**<br /><br />string<br /><br />Conditionally returned   | Identifies the user who last changed the Commando Mode control set’s state.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                |
| data\[].**type**<br /><br />string<br /><br />Conditionally returned                  | Specifies the type of event that triggered the Commando Mode transition, such as a `connection_error` or `response_timeout`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                               |
| end\_index<br /><br />integer<br /><br />Conditionally returned                       | Sort order index of the last resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                                                                                                                                                                                |
| is\_more<br /><br />boolean<br /><br />Conditionally returned                         | Value of `true` indicates that more unreturned resources exist.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                                                                         |
| start\_index<br /><br />integer<br /><br />Conditionally returned                     | Sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                                                                                                                                                                               |

<h3 id="_sample_response_body_4">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "token": "commando_mode_1_transition",
      "commando_mode_token": "commando_mode_1",
      "transition": {
        "commando_enabled": true,
        "reason": "Lost connection",
        "channel": "API"
      },
      "user_name": "rhowse",
      "created_time": "2023-02-14T18:48:10Z"
    }
  ]
}
```


## Related topics

- [Commando Mode Addendum](/docs/core-api/commando-mode-addendum.md)
- [Error Handling in Europe](/docs/developer-guides/mq-eu-error-handling.md)
- [Control Center in the Marqeta Dashboard](/docs/developer-guides/control-center-dashboard.md)
- [Errors](/docs/core-api/errors.md)
- [Release Notes](/docs/developer-guides/release-notes-2025.md)
