Skip to main content
PUT
/
cards
/
account
/
configuration
/
velocity-rules
curl -X PUT "https://api.cryptomate.me/cards/account/configuration/velocity-rules" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rules": [
      { "max_authorizations": 3, "time_window_seconds": 60 },
      { "max_authorizations": 10, "time_window_seconds": 3600 }
    ]
  }'

{
  "rules": [
    {
      "max_authorizations": 3,
      "time_window_seconds": 60
    },
    {
      "max_authorizations": 10,
      "time_window_seconds": 3600
    }
  ]
}
Replaces the entire set of velocity rules for your company. You can configure up to 5 rules. Each rule limits the number of approved card authorizations within a sliding time window, applied independently per card. When a card exceeds any rule during an authorization, the transaction is declined and the card is blocked until manually unblocked. Unblocking the card also resets its authorization counter. Sending an empty rules array removes all rules — no validation occurs if no rules are configured. Requires an API key with access level 2 or higher.

​
Body

​
rules
array
required
Full set of velocity rules to apply. Up to 5 rules. Each rule must have a unique time_window_seconds value.

​
Response

Returns the updated list of rules as stored.
​
rules
array

​
Errors

CodeDescription
VELOCITY_RULES_LIMIT_EXCEEDEDMore than 5 rules provided.
VELOCITY_RULES_DUPLICATE_WINDOWTwo or more rules share the same time_window_seconds.
VALIDATION_ERRORA field is missing or has an invalid value (e.g. max_authorizations < 1).
curl -X PUT "https://api.cryptomate.me/cards/account/configuration/velocity-rules" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rules": [
      { "max_authorizations": 3, "time_window_seconds": 60 },
      { "max_authorizations": 10, "time_window_seconds": 3600 }
    ]
  }'

{
  "rules": [
    {
      "max_authorizations": 3,
      "time_window_seconds": 60
    },
    {
      "max_authorizations": 10,
      "time_window_seconds": 3600
    }
  ]
}