Skip to main content
Weavr API
Spend controls

List card spend rules

GET/managed_cards/{id}/spend_rules

Returns the spend rules in force for the managed card identified by the id path parameter.

The response separates the two levels at which rules are configured: the profile-level rules that apply to every card on the Managed Card Profile, and the card-level rules set for this card alone. An authorization must satisfy both, so read them together when working out why a transaction was declined.

Each spend limit is returned with its interval and its rollover policy. When rolloverNegative is enabled, overspend is carried into subsequent intervals and reduces the card's available-to-spend amount until it becomes positive.

Request

Available on
SandboxProduction

Path parameters

Responses

200OK

Success

Headers
Body
application/json
{}
AllLevelSpendRulesAllLevelSpendRules · object · 17 fields
Response example
{  "allowedMerchantCategories": [    "string"  ],  "blockedMerchantCategories": [    "string"  ],  "allowedMerchantIds": [    "string"  ],  "blockedMerchantIds": [    "string"  ],  "allowedMerchantCountries": [    "string"  ],  "blockedMerchantCountries": [    "string"  ],  "allowContactless": true,  "allowAtm": true,  "allowECommerce": true,  "allowCashback": true,  "allowCreditAuthorisations": true,  "minTransactionAmount": 100,  "maxTransactionAmount": 50000,  "spendLimit": [    {      "startTimestamp": 1767225600000,      "value": {        "currency": "GBP",        "amount": 1250      },      "interval": "DAILY"    }  ],  "cardLevelSpendRules": {    "allowedMerchantCategories": [      "string"    ],    "blockedMerchantCategories": [      "string"    ],    "allowedMerchantIds": [      "string"    ],    "blockedMerchantIds": [      "string"    ],    "allowedMerchantCountries": [      "string"    ],    "blockedMerchantCountries": [      "string"    ],    "allowContactless": true,    "allowAtm": true,    "allowECommerce": true,    "allowCashback": true,    "allowCreditAuthorisations": true,    "rolloverPolicy": {      "rolloverNegative": false    },    "spendLimit": [      {        "startTimestamp": 1767225600000,        "value": {          "currency": "GBP",          "amount": 1250        },        "interval": "DAILY"      }    ],    "minTransactionAmount": 100,    "maxTransactionAmount": 50000  },  "profileLevelSpendRules": {    "allowedMerchantCategories": [      "string"    ],    "blockedMerchantCategories": [      "string"    ],    "allowedMerchantIds": [      "string"    ],    "blockedMerchantIds": [      "string"    ],    "allowedMerchantCountries": [      "string"    ],    "blockedMerchantCountries": [      "string"    ],    "allowContactless": true,    "allowAtm": true,    "allowECommerce": true,    "allowCashback": true,    "allowCreditAuthorisations": true,    "rolloverPolicy": {      "rolloverNegative": false    },    "authForwardingEnabled": false  },  "identityLevelSpendRules": {    "allowedMerchantCategories": [      "string"    ],    "blockedMerchantCategories": [      "string"    ],    "allowedMerchantIds": [      "string"    ],    "blockedMerchantIds": [      "string"    ],    "allowedMerchantCountries": [      "string"    ],    "blockedMerchantCountries": [      "string"    ],    "allowContactless": true,    "allowAtm": true,    "allowECommerce": true,    "allowCashback": true,    "allowCreditAuthorisations": true,    "rolloverPolicy": {      "rolloverNegative": false    },    "minTransactionAmount": 100,    "maxTransactionAmount": 50000  }}