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

# Update external card

> Updates an external card.

PATCH/v3/moneymovement/externalcards/\{token}

Updates an external card.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the external card, as returned by the `POST /externalcards` endpoint. **Allowable Values:**  Valid external card token |

## Request body

| Fields | Description |
| - | - |
| status string  Required | Status to which to update the external card. **Allowable Values:**  `TERMINATED`, `SUSPENDED`, `ACTIVE` |

## Sample request body

Suspend an external card

```json JSON lines wrap theme={null}
{
  "status": "SUSPENDED"
}
```

Terminate an external card

```json JSON lines wrap theme={null}
{
  "status": "TERMINATED"
}
```

Reactivate a suspended external card

```json JSON lines wrap theme={null}
{
  "status": "ACTIVE"
}
```

## Response body

| Fields | Description |
| - | - |
| token string  Conditionally returned | Unique identifier of the external card. **Allowable Values:**  36 char max |
| expiration string  Conditionally returned | Expiration date of the external card. **Allowable Values:**  Format: `MMyy` |
| last\_four string  Conditionally returned | Last four digits of the primary account number (PAN) of the external card. **Allowable Values:**  4 char |
| issuing\_bank string  Conditionally returned | Issuing bank of the external card. **Allowable Values:**  Bank name, as provided by the card network |
| network string  Conditionally returned | Name of the card network. **Allowable Values:**  255 char max |
| status string  Conditionally returned | Status of the external card. **Allowable Values:**  `ACTIVE`, `SUSPENDED`, `TERMINATED` |
| user\_token string  Conditionally returned | Unique identifier of the user. **Allowable Values:**  36 char max |
| business\_token string  Conditionally returned | Unique identifier of the business. **Allowable Values:**  36 char max |
| billing\_details object  Conditionally returned | Billing details. **Allowable Values:**  Valid billing details object |
| billing\_details.**first\_name** string  Conditionally returned | First name or given name of the external account holder. **Allowable Values:**  40 char max |
| billing\_details.**middle\_name** string  Conditionally returned | Middle name of the external account holder. **Allowable Values:**  40 char max |
| billing\_details.**last\_name** string  Conditionally returned | Last or family name of the external account holder. **Allowable Values:**  40 char max |
| billing\_details.**business\_name** string  Conditionally returned | Business name of the external account holder. **Allowable Values:**  40 char max |
| billing\_details.**address\_1** string  Returned | Street name and number of the external account holder's address. **Allowable Values:**  255 char max |
| billing\_details.**address\_2** string  Conditionally returned | Additional external account holder address information. **Allowable Values:**  255 char max |
| billing\_details.**city** string  Returned | City of the external account holder's address. **Allowable Values:**  40 char max |
| billing\_details.**country\_subdivision** string  Returned | Two-character state, province, or territorial abbreviation. For a complete list of valid abbreviations, see [Valid state, provincial, and territorial abbreviations](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations). **Allowable Values:**  2 chars |
| billing\_details.**postal\_code** string  Returned | Postal code of the external account holder's address. **Allowable Values:**  20 char max |
| billing\_details.**country** string  Returned | Country of the external account holder's address in a valid alpha-3 [ISO 3166 country code](https://www.iso.org/iso-3166-country-codes.html). **Allowable Values:**  3 chars |
| is\_eligible\_for\_pull boolean  Conditionally returned | A value of `true` indicates that the external card is eligible for pulling funds. **Allowable Values:**  `true`, `false` |
| is\_eligible\_for\_push boolean  Conditionally returned | A value of `true` indicates that the external card is eligible for pushing funds. **Allowable Values:**  `true`, `false` |
| is\_eligible\_for\_disbursement boolean  Conditionally returned | A value of `true` indicates that the external card is eligible for disbursement. **Allowable Values:**  `true`, `false` |
| created\_time datetime  Conditionally returned | Date and time when the external card was created, in UTC. **Allowable Values:**  Format: `yyyy-MM-ddThh:mm:ssZ` |
| last\_modified\_time datetime  Conditionally returned | Date and time when the external card was updated, in UTC. **Allowable Values:**  Format: `yyyy-MM-ddThh:mm:ssZ` |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "ext_card_12345",
  "expiration": "1230",
  "last_four": "1111",
  "status": "SUSPENDED",
  "user_token": "user_67890",
  "billing_details": {
    "first_name": "Jane",
    "last_name": "Doe",
    "address_1": "123 Main Street",
    "city": "Oakland",
    "country_subdivision": "CA",
    "postal_code": "94612",
    "country": "USA"
  },
  "is_eligible_for_pull": true,
  "is_eligible_for_push": true,
  "is_eligible_for_disbursement": true,
  "created_time": "2025-01-15T17:30:45Z",
  "last_modified_time": "2025-03-10T14:45:20Z"
}
```


## Related topics

- [External Cards Overview](https://www.marqeta.com/docs/core-api/external-cards.md)
- [Instant Card Transfers](https://www.marqeta.com/docs/developer-guides/instant-card-transfers.md)
- [Update card information for Click to Pay for Visa](https://www.marqeta.com/docs/core-api/digital-wallets-management/click-to-pay-visa/update-card-information-click-pay-visa.md)
- [Retrieve external card](https://www.marqeta.com/docs/core-api/external-cards/retrieve-external-card.md)
- [Add external card](https://www.marqeta.com/docs/core-api/external-cards/add.md)
