Apply spending limits

EasyCard funding is corporate: POST /wallet/fund increases company spending power shared across every card. Use card limits to control how much an individual card can spend.

Before you start

A card exists (GET /cards/{cardId} or list cards for the user)
Corporate programme has spending power if you expect live spend (GET /wallet/balance)

See Fund and withdraw for programme funding.

Set a limit

POST /cards/CARD_ID/limits

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/cards/CARD_ID/limits" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000,
    "frequency": "per24HourPeriod"
  }'

Success is HTTP 200 with an empty body. Confirm with GET /cards/{cardId}.

Field	Meaning
`amount`	Cap in integer cents (for example `25000` = $250.00)
`frequency`	Window the cap applies to

Frequencies

Value	Window
`perAuthorization`	Each authorization
`per24HourPeriod`	Rolling 24 hours
`per7DayPeriod`	Rolling 7 days
`per30DayPeriod`	Rolling 30 days
`perYearPeriod`	Rolling year
`allTime`	Lifetime on the card

Call again with a different frequency to set an additional cap (for example a daily and a monthly limit).

Read limit and period spend

Card list and detail include the stored limit and spend in the active window:

GET /cards/CARD_ID

curl -s "https://b2b-api.easyonramp.com/api/v1/cards/CARD_ID" \
  -H "Authorization: Bearer YOUR_JWT"

Field	Meaning
`limit`	Stored Rain limit (`amount`, and frequency when present)
`periodSpendCents`	Completed spend in the active frequency window (cents)

For custom ranges, use Reports with cardId and matching from / to.

How limits relate to funding

Funding raises company spending power.
Limits do not move funds; they only cap what that card can authorize within the frequency window.
A card still cannot spend more than remaining corporate spending power.

Get started

Core concepts

Common workflows

How to manage users

How to fund your business wallet

How to use cards

How to use reports

Integration services

Before you start

Set a limit

Frequencies

Read limit and period spend

How limits relate to funding

​Before you start

​Set a limit

​Frequencies

​Read limit and period spend

​How limits relate to funding

​Related

Before you start

Set a limit

Frequencies

Read limit and period spend

How limits relate to funding

Related