Skip to main content
PATCH
/
cards
/
{card_id}
Update Card
curl --request PATCH \
  --url https://api.meow.com/v1/cards/{card_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "nickname": "<string>",
  "spending_controls": {
    "per_transaction_limit": 12500,
    "daily_limit": 500000000,
    "weekly_limit": 500000000,
    "monthly_limit": 500000000,
    "yearly_limit": 500000000,
    "all_time_limit": 500000000
  },
  "allowed_categories": []
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "display_name": "<string>",
  "last_four": "<string>",
  "is_physical": true,
  "cardholder": {
    "name": "<string>",
    "public_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "is_single_use": false,
  "expiration": "2023-11-07T05:31:56Z",
  "spending_restriction": {
    "merchants": [
      "<string>"
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Headers

​
x-entity-id
string<uuid>

Optional entity_id to scope requests to a specific entity.

Path Parameters

​
card_id
string<uuid>
required

Body

application/json
​
status
enum<string> | null

Set to inactive to freeze the card or active to unfreeze it.

Available options:
active,
inactive
​
nickname
string | null

Rename the card's display name (max 30 characters).

Required string length: 1 - 30
Pattern: ^[ -~]+$
​
spending_controls
SpendingControls · object | null

Replace the card's spend limits.

​
allowed_categories
enum<string>[] | null

Restrict the card to these merchant categories. Pass null to clear all category restrictions.

Available options:
Advertising,
Airlines,
Books and Newspapers,
Car Rental,
Charity,
Clothing,
Electronics,
Entertainment,
Facilities Expenses,
Financial Institutions and Fees,
Fuel,
Furniture,
Government Services,
Grocery,
Ground Transportation,
Insurance,
Legal,
Lodging,
Meals,
Medical,
Office Supplies,
Parking,
Political,
Professional Services,
Recruiting,
Rent,
Restaurants,
Shipping,
Software,
Taxes,
Taxis and Rideshare,
Technology Infrastructure,
Training and Education,
Utilities,
Vehicle Expenses

Response

Successful Response

​
id
string<uuid>
required

Unique card identifier.

​
display_name
string
required

Card name or nickname.

​
last_four
string
required

Last 4 digits of the card number.

​
status
enum<string>
required

Card status.

Available options:
pending,
active,
suspended,
closed,
failed
​
platform
enum<string>
required

The platform that issued this card.

Available options:
stripe,
awx
​
is_physical
boolean
required

Whether this is a physical card.

​
cardholder
CardCardholder · object
required

Cardholder info.

​
created_at
string<date-time>
required

Card creation timestamp.

​
is_single_use
boolean
default:false

Whether this is a single-use card.

​
expiration
string<date-time> | null

Card expiration date.

​
spending_restriction
CardSpendingRestriction · object | null

Merchant spending restrictions.