Skip to main content
PATCH
Change a card's limit
Sets a new total limit on a user-funded multi-use card. A company-funded card moves company money, so raise it with a top-up.

Authorizations

Authorization
string
header
required

A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.

Path Parameters

card_id
string
required

Body

application/json
spend_limit_cents
integer
required

The new total limit, in cents. At least 100.

Required range: x >= 100

Response

The card.

object
enum<string>
required

Always card.

Available options:
card
id
string
required

The card's id.

status
string
required

creating, open, in_use, paused, pausing, closing, or closed.

type
string
required

single_use or multi_use.

spend_limit_cents
integer
required

What the card can spend in all.

balance_cents
integer
required

What's left to spend.

last4
string
required

The last four digits.

expiry
string
required

MM/YY.

created_at
string<date-time>
required

When it was issued.

user_id
string | null

The user the card is for.

cardholder_name
string

The name the card was issued in, for the payment form.

billing_address
string

The billing address, for the payment form.

funds_source
string

On a new card: what funded it.

transfer_id
string

On a company-funded new card: the transfer that funded it.

closed_reason
string

Only when closed: used, canceled, expired, declined.

card_expires_at
string<date-time>

When a multi_use card closes itself.