Ramp: Fetch a spend program — response body

API reference · Contract 2026-10-27

SDK schema: Fetch a spend program — response body

Field	Type	Presence	Description and constraints
$	object	Root
custom_form_collection	JSON	Required within parent
custom_form_collection (anyOf 1)	Model	Alternative	Expand Fetch a spend program — response body — custom form collection custom form collection log entry Custom form collection for the resource, e.g. form questions required to create a request against a spend program. Read only: true
custom_form_collection (anyOf 2)	null	Alternative
description	string	Required within parent	Description of the spend program.
display_name	string	Required within parent	Display name of the spend program.
icon	string	Required within parent	The template icon for the spend program. Known values: AccountingServicesIcon, AdvertisingIcon, CONTRACTORS_AND_PROFESSIONAL_SERVICES, CUSTOM, CardIcon, EducationStipendIcon, EmployeeRewardsIcon, GroundTransportationIcon, LegalFeesIcon, LodgingIcon, LunchOrderingIcon, OnboardingIcon, PerDiemCardIcon, SOFTWARE, SaasSubscriptionIcon, SoftwareTrialIcon, SuppliesIcon, TeamSocialIcon, TravelExpensesIcon, VirtualEventIcon, WellnessIcon, WorkFromHomeIcon, advertising, airlines, bills, business, car_services, contractor, education, entertainment, event_balloons, event_virtual, food, fuel_and_gas, general_expense, general_merchandise, gift, government_services, internet_and_phone, legal, lodging, lodging_room, newspaper, office, physical_card, procurement_checklist, procurement_intake, professional_services, restaurants, reward, saas_software, shipping, travel_misc, wellness
id	string	Required within parent	Unique identifier of the spend program. Format: uuid
is_shareable	boolean	Required within parent	Whether this spend program is shareable.
issue_physical_card_if_needed	boolean	Required within parent	Indicates whether the spend program should issue a physical card if the user does not have one.
line_item_accounting_fields	array	Required within parent	Custom accounting fields enabled for line items in this spend program. Read only: true
line_item_accounting_fields[]	Model	Each item	Expand Fetch a spend program — response body — line item accounting fields item
line_item_custom_fields	array	Required within parent	Custom fields enabled for line items in this spend program. Read only: true
line_item_custom_fields[]	Model	Each item	Expand Fetch a spend program — response body — line item custom fields item
permitted_spend_types	JSON	Required within parent
permitted_spend_types (anyOf 1)	Model	Alternative	Expand Fetch a spend program — response body — permitted spend types primary card enabled, reimbursements enabled Permitted spend types for the spend program.
permitted_spend_types (anyOf 2)	null	Alternative
restrictions	JSON	Required within parent
restrictions (anyOf 1)	Model	Alternative	Expand 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 A set of restrictions imposed on the spend program. Read only: true
restrictions (anyOf 2)	null	Alternative

Referenced models: Fetch a spend program — response body — permitted spend types primary card enabled, reimbursements enabled, Fetch a spend program — response body — custom form collection custom form collection log entry, Fetch a spend program — response body — line item accounting fields item, Fetch a spend program — response body — line item custom fields item, 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