Skip to content

Ramp: Create a spend program — request body — body spending restrictions

Create a spend program: request body, field body / spending_restrictions. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Create a spend program — request body — body spending restrictions

FieldTypePresenceDescription and constraints
$objectRoot
allowed_categoriesarrayOptionalList of Ramp category codes allowed for the limit.
allowed_categories[]integerEach itemOne of: 1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 2, 20, 21, 23, 24, 25, 26, 27, 28, 29, 3, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 4, 40, 41, 42, 43, 44, 5, 6, 7, 8, 9
allowed_vendorsarrayOptionalList of merchants allowed for the limit.
allowed_vendors[]stringEach itemFormat: uuid
blocked_categoriesarrayOptionalList of Ramp category codes blocked for the limit.
blocked_categories[]integerEach itemOne of: 1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 2, 20, 21, 23, 24, 25, 26, 27, 28, 29, 3, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 4, 40, 41, 42, 43, 44, 5, 6, 7, 8, 9
blocked_mcc_codesarrayOptional
blocked_mcc_codes[]stringEach item
blocked_vendorsarrayOptionalList of merchants blocked for the limit.
blocked_vendors[]stringEach itemFormat: uuid
intervalstringRequired within parentTime interval to apply limit to.
One of: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY
limitModelRequired within parentExpand Create a fund — request body — body spending restrictions limit
Total amount limit per interval denominated in the smallest currency unit (e.g. cents for USD).
lock_datestringOptionalDate to automatically lock the card. If lock date has passed, set to a future date or to null to unlock the card.
Format: date-time
transaction_amount_limitModelOptionalExpand Create a fund — request body — body spending restrictions limit
Max amount per transaction denominated in the smallest currency unit (e.g. cents for USD).

Referenced models: Create a fund — request body — body spending restrictions limit

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.