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

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.

Body

application/json
​
amount
integer
required

Maximum spend limit in whole dollars.

Required range: x <= 25000
​
merchant_name
string
required

Name of the merchant.

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

Brief description of what you are purchasing and why.

​
currency
enum<string>
default:USD

Three-letter ISO 4217 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

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

Restrict the card to these 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, the card is revoked automatically after the first authorization. If false, the 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"