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>"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.meow.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Your Meow API key for authentication

Headers

​
x-entity-id
string<uuid>

Optional entity ID for scoped access to entity-specific data

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

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/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

Issuing platform (awx or stripe)

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

Merchant spending restrictions