Skip to main content
POST
/
cards
Create Card
curl --request POST \
  --url https://api.meow.com/v1/cards \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "amount": 123,
  "merchant_name": "<string>",
  "task_description": "<string>",
  "currency": "USD",
  "nickname": "<string>",
  "allowed_categories": [],
  "expires_in_minutes": 60,
  "single_use": true
}
'
{
  "controls": {
    "spending_limit": 123,
    "single_use": true,
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "metadata": {
    "card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "task_description": "<string>"
  },
  "payment_type": "card"
}

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

Body

application/json
​
amount
integer
required

Maximum spend limit in whole dollars

Required range: x <= 25000
​
merchant_name
string
required

Name of the merchant (for audit trail)

Required string length: 1 - 100
Pattern: ^[ -~]+$
​
task_description
string
required

Brief description of what the agent is purchasing and why

​
currency
enum<string>
default:USD

Three-letter ISO currency code

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BOV,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHE,
CHF,
CHW,
CLF,
CLP,
CNY,
COP,
COU,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MXV,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SLE,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
USN,
UYI,
UYU,
UYW,
UZS,
VED,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XBA,
XBB,
XBC,
XBD,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
XSU,
XTS,
XUA,
XXX,
YER,
ZAR,
ZMW,
ZWG,
ZWL
​
nickname
string | null

Optional display name for the card (max 30 characters). Defaults to the merchant name when omitted.

Required string length: 1 - 30
Pattern: ^[ -~]+$
​
allowed_categories
enum<string>[] | null

Optional: restrict card to specific merchant categories

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
​
expires_in_minutes
integer
default:60

Card expires after this many minutes (default: 60)

Required range: x <= 1440
​
single_use
boolean
default:true

If true, card auto-cancels after first authorization. If false, card stays usable until expiry or explicit revoke.

Response

Successful Response

​
controls
CardControls · object
required
​
metadata
CardMetadata · object
required
​
payment_type
string
default:card
Allowed value: "card"