Limit types
When you call the card limits endpoints, each limit has a name from this list (CardLimitType).
Not every card has every type. Use GET /cards/{cardKey}/limits to see which limits exist for that card.
Physical vs virtual: any limit with ATM in the name is for physical cards only. Virtual cards cannot use ATMs, so those limits are not returned and cannot be set.
Codes
| Code | Period | Unit | Card type | Meaning |
|---|---|---|---|---|
POS_PUR_LMT | Day | Amount | Physical + Virtual | How much can be spent in shops (POS) per day |
ATM_CCA_LMT | Day | Amount | Physical only | How much can be withdrawn from ATMs (cash) per day |
CNP_AMT_LMT | Day | Amount | Physical + Virtual | How much can be spent when the card is not present (CNP) per day |
ECOMM_AMT_LMT | — | Amount | Physical + Virtual | How much can be spent online (e-commerce) |
ATM_USE_LMT | Day | Count | Physical only | How many ATM cash withdrawals are allowed per day |
MONTH_POS_PUR_LMT | Month | Amount | Physical + Virtual | How much can be spent in shops (POS) per month |
MONTH_ATM_CCA_LMT | Month | Amount | Physical only | How much can be withdrawn from ATMs (cash) per month |
MONTH_AMT_CNP_LMT | Month | Amount | Physical + Virtual | How much can be spent when the card is not present (CNP) per month |
POS_USE_LMT | - | Count | Physical + Virtual | How many non-cash (POS) transactions are allowed |
MONTH_TRANS_AMT_LMT | Month | Amount | Physical + Virtual | Total spend across all transaction types per month |
PERIOD_TRANS_AMT | Billing period | Amount | Physical + Virtual | Total spend for the billing period |
Unit
- Amount — money (same currency as the card)
- Count — number of transactions
Where these codes are used
| Endpoint | How name is used |
|---|---|
GET /cards/{cardKey}/limits | Each row has a name from the table above |
PATCH /cards/{cardKey}/limits | Send name + value for each limit you want to change |
GET /cards/{cardKey}/limits/{limitName}/available | Path limitName is one of these codes |
For how approval works (approvalThreshold, max), see Cards overview → Limits.