Ramp: Fetch a vendor agreement — response body — purchase orders item spend request

Fetch a vendor agreement: response body, field purchase_orders / item / spend_request. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Fetch a vendor agreement — response body — purchase orders item spend request

Field	Type	Presence	Description and constraints
`$`	object	Root
`approved_at`	JSON	Required within parent
`approved_at (anyOf 1)`	string	Alternative	Date when the spend request was approved. Default: null Format: date
`approved_at (anyOf 2)`	null	Alternative
`currency`	string	Required within parent	Currency code for the spend request amounts.
`id`	string	Required within parent	Format: uuid
`name`	JSON	Required within parent
`name (anyOf 1)`	string	Alternative	Name of the spend request. Default: null
`name (anyOf 2)`	null	Alternative
`source`	string	Required within parent	Known values: EXPANSION_REQUEST, RENEWAL, REQUEST_APPROVAL, REQUEST_LINKED_TO_AGREEMENT
`submitted_at`	JSON	Optional
`submitted_at (anyOf 1)`	string	Alternative	Format: date-time
`submitted_at (anyOf 2)`	null	Alternative
`total_amount`	JSON	Optional
`total_amount (anyOf 1)`	Model	Alternative	Expand Hold Bill — response body — amount
`total_amount (anyOf 2)`	null	Alternative
`unified_request_id`	string	Required within parent	Format: uuid
`user_full_name`	string	Required within parent	Full name of the user who created the spend request.