Ramp: Fetch a spend program — response body — restrictions allowed categories, allowed vendors, auto lock date, blocked categories, blocked vendors, interval, limit, next interval reset, start of interval, temporary limit, transaction amount limit
Fetch a spend program: response body, field restrictions / allowed_categories, allowed_vendors, auto_lock_date, blocked_categories, blocked_vendors, interval, limit, next_interval_reset, start_of_interval, temporary_limit, transaction_amount_limit. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a spend program — response body — restrictions allowed categories, allowed vendors, auto lock date, blocked categories, blocked vendors, interval, limit, next interval reset, start of interval, temporary limit, transaction amount limit
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
allowed_categories | array | Required within parent | List of Ramp category codes allowed for the limit. |
allowed_categories[] | JSON | Each item | |
allowed_categories[] (anyOf 1) | integer | Alternative | Known values: 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_categories[] (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
allowed_vendors | array | Required within parent | List of merchants allowed for the limit. |
allowed_vendors[] | string | Each item | Format: uuid |
auto_lock_date | JSON | Required within parent | |
auto_lock_date (anyOf 1) | string | Alternative | Date to automatically to lock the limit. Format: date-time |
auto_lock_date (anyOf 2) | null | Alternative | |
blocked_categories | array | Required within parent | List of Ramp category codes blocked for the limit. |
blocked_categories[] | JSON | Each item | |
blocked_categories[] (anyOf 1) | integer | Alternative | Known values: 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_categories[] (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
blocked_vendors | array | Required within parent | List of merchants blocked for the limit. |
blocked_vendors[] | string | Each item | Format: uuid |
interval | string | Required within parent | Time interval the limit is applied on. Known values: ANNUAL, CUSTOM, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY |
limit | JSON | Required within parent | |
limit (anyOf 1) | Model | Alternative | Expand Hold Bill — response body — amount Amount limit total per interval denominated in the smallest currency unit (e.g. cents for USD). Read only: true |
limit (anyOf 2) | null | Alternative | |
next_interval_reset | JSON | Required within parent | |
next_interval_reset (anyOf 1) | string | Alternative | Date and time for the next interval reset. Format: date-time |
next_interval_reset (anyOf 2) | null | Alternative | |
start_of_interval | JSON | Required within parent | |
start_of_interval (anyOf 1) | string | Alternative | Date and time for the start of the current interval. Format: date-time |
start_of_interval (anyOf 2) | null | Alternative | |
temporary_limit | JSON | Required within parent | |
temporary_limit (anyOf 1) | Model | Alternative | Expand Hold Bill — response body — amount Temporary limit total per interval. Read only: true |
temporary_limit (anyOf 2) | null | Alternative | |
transaction_amount_limit | JSON | Required within parent | |
transaction_amount_limit (anyOf 1) | Model | Alternative | Expand Hold Bill — response body — amount Max amount allowed on a single transaction. Read only: true |
transaction_amount_limit (anyOf 2) | null | Alternative |
Referenced models: Hold Bill — response body — amount