Update Card
Updates an issued card. All fields are optional; only the fields you pass are changed. Updates the card name, billing address, and spending limits in one call, sets a new PIN, freezes or unfreezes the card, or cancels it. Pass canceled: true alone to cancel the card — cancellation is permanent and a canceled card cannot be uncanceled. Pass exactly one of account_id (a biz_ identifier) or user_id (a user_ identifier). Assigned cardholders without the payout:account:update scope can update the PIN and freeze state of their own card. The PIN can only be changed on a card assigned to the acting user. Returns the updated card resource.
Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
Pins the request to a dated API version.
"2026-07-20"
Path Parameters
Card ID to retrieve, prefixed icrd_.
Body
The owning account ID (a biz_ identifier). Provide this or user_id.
New billing address. Requires line1, city, region, postal_code, and country_code.
Pass true to permanently cancel the card. A canceled card cannot be uncanceled. Cannot be combined with other fields.
Pass true to freeze the card, false to unfreeze it.
A display name for the card.
New 4-digit PIN. Can only be set on a card assigned to the acting user.
Pass true to remove the spending limit (make the card unlimited).
Spending limit amount, in dollars.
The spending limit window.
daily, weekly, monthly, one_time Per-transaction limit amount, in dollars.
The owning user ID (a user_ identifier). Provide this or account_id.
Response
card canceled
The billing address.
When the card was canceled.
When the card was created.
Card expiration month.
Card expiration year.
Card ID, prefixed icrd_.
Last four digits of the card number. null for pending invitation cards.
The spending limit configuration.
Card display name.
card Total spend in the last 30 days, in cents.
The card status.
null, active, frozen, canceled, invited The card type.
null, virtual, physical Cardholder user ID, prefixed user_, when assigned.
Sensitive card details. Present only on GET /cards/:card_id for active cards; null when the card is inactive or details cannot be retrieved.

