--- title: "Renew a Card" method: POST path: "/cards/{card_id}/renew" --- # Renew a Card `POST /cards/{card_id}/renew` ## Request - Base URL: `https://api.increase.com` - URL: `https://api.increase.com/cards/{card_id}/renew` - Auth: HTTP bearer Renew a Card in place. The Card keeps its identifier, card number, PIN, and Physical Cards, and receives a new expiration date in the current month four years from now along with a new verification code, which the Card's details will return afterwards. Physical Cards that have already shipped keep working until they are canceled. ## Path parameters - `card_id` string, required: The identifier of the Card to renew. ## Response `200` Card - Card: Cards may operate on credit, debit, or prepaid BINs. They’ll immediately work for online purchases after you create them. All cards work on a good funds model, and maintain a maximum limit of 100% of the Account’s available balance at the time of transaction. Funds are deducted from the Account upon transaction settlement. For more information, see our guide on [managing cards](https://increase.com/documentation/managing-cards). - `account_id` string, required: The identifier for the account this card belongs to. - `authorization_controls` object, nullable, required: Controls that restrict how this card can be used. - `merchant_acceptor_identifier` object, nullable, required: Restricts which Merchant Acceptor IDs are allowed or blocked for authorizations on this card. - `allowed` object[], nullable, required: The Merchant Acceptor IDs that are allowed for authorizations on this card. - `identifier` string, required: The Merchant Acceptor ID. - `blocked` object[], nullable, required: The Merchant Acceptor IDs that are blocked for authorizations on this card. - `identifier` string, required: The Merchant Acceptor ID. - `merchant_category_code` object, nullable, required: Restricts which Merchant Category Codes are allowed or blocked for authorizations on this card. - `allowed` object[], nullable, required: The Merchant Category Codes that are allowed for authorizations on this card. - `code` string, required: The Merchant Category Code (MCC). - `blocked` object[], nullable, required: The Merchant Category Codes that are blocked for authorizations on this card. - `code` string, required: The Merchant Category Code (MCC). - `merchant_country` object, nullable, required: Restricts which merchant countries are allowed or blocked for authorizations on this card. - `allowed` object[], nullable, required: The merchant countries that are allowed for authorizations on this card. - `country` string, required: The ISO 3166-1 alpha-2 country code. - `blocked` object[], nullable, required: The merchant countries that are blocked for authorizations on this card. - `country` string, required: The ISO 3166-1 alpha-2 country code. - `usage` object, nullable, required: Controls how many times this card can be used. - `category` 'single_use' | 'multi_use', required: Whether the card is for a single use or multiple uses. - `multi_use` object, nullable, required: Controls for multi-use cards. Required if and only if `category` is `multi_use`. - `spending_limits` object[], nullable, required: Spending limits for this card. The most restrictive limit applies if multiple limits match. - `interval` 'all_time' | 'per_transaction' | 'per_day' | 'per_week' | 'per_month', required: The interval at which the spending limit is enforced. - `merchant_category_codes` object[], nullable, required: The Merchant Category Codes (MCCs) this spending limit applies to. If not set, the limit applies to all transactions. - `code` string, required: The Merchant Category Code (MCC). - `settlement_amount` integer, required: The maximum settlement amount permitted in the given interval. - `single_use` object, nullable, required: Controls for single-use cards. Required if and only if `category` is `single_use`. - `settlement_amount` object, required: The settlement amount constraint for this single-use card. - `comparison` 'equals' | 'less_than_or_equals', required: The operator used to compare the settlement amount. - `value` integer, required: The settlement amount value. - `billing_address` object, required: The Card's billing address. - `city` string, nullable, required: The city of the billing address. - `line1` string, nullable, required: The first line of the billing address. - `line2` string, nullable, required: The second line of the billing address. - `postal_code` string, nullable, required: The postal code of the billing address. - `state` string, nullable, required: The US state of the billing address. - `bin` string, required: The Bank Identification Number (BIN) of the Card. - `cardholder_name` object, nullable, required: The name of the cardholder. Used to respond to Account Name Inquiry requests from acquirers in Card Validations. - `first` string, required: The cardholder's first name. - `last` string, required: The cardholder's last name. - `middle` string, nullable, required: The cardholder's middle name. - `created_at` string, date-time, required: The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created. - `description` string, nullable, required: The card's description for display purposes. - `digital_wallet` object, nullable, required: The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps. - `digital_card_profile_id` string, nullable, required: The digital card profile assigned to this digital card. Card profiles may also be assigned at the program level. - `email` string, nullable, required: An email address that can be used to verify the cardholder via one-time passcode over email. - `phone` string, nullable, required: A phone number that can be used to verify the cardholder via one-time passcode over SMS. Returned in [E.164](https://en.wikipedia.org/wiki/E.164) format, for example `+14155550123`. - `entity_id` string, nullable, required: The identifier for the entity associated with this card. - `expiration_month` integer, required: The month the card expires in M format (e.g., August is 8). - `expiration_year` integer, required: The year the card expires in YYYY format (e.g., 2025). - `id` string, required: The card identifier. - `idempotency_key` string, nullable, required: The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys). - `last4` string, required: The last 4 digits of the Card's Primary Account Number. - `renewals` object[], required: Completed renewals of this Card, sorted by `renewed_at` in ascending order. Each renewal records the expiration date the Card had before it was renewed. - `previous_expiration_month` integer, required: The month the Card expired in before this renewal, in M format (e.g., August is 8). - `previous_expiration_year` integer, required: The year the Card expired in before this renewal, in YYYY format (e.g., 2025). - `renewed_at` string, date-time, required: The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was renewed. - `replacement_for` object, nullable, required: Details about the Card this Card replaces, if it was created as a replacement. - `card_id` string, required: The identifier of the replaced Card. - `reason` 'expiring' | 'lost' | 'stolen' | 'fraud', required: Why the Card was replaced. Only `expiring` notifies merchants that have the replaced Card on file of the new Card and moves Digital Wallet Tokens on the replaced Card that have not been deactivated to the new Card. - `status` 'active' | 'disabled' | 'canceled', required: This indicates if payments can be made with the card. - `type` 'card', required: A constant representing the object's type. For this resource it will always be `card`. ## Other responses - `4XX`: Error - `5XX`: Error ## Changes - **2026-10-15** `7e848d866205`: 1 info - added the required property `replacement_for` to the response with the `200` status - **2026-10-14** `d410a6abb15d`: 1 info - endpoint added [Operation history](https://skmtc.dev/increase/apis/increase-api-2/changes/cards/:card_id/renew/post.md) --- [API](https://skmtc.dev/increase/apis/increase-api-2.md) - [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/efeb9b9f8ecc?raw)