Ramp: List unified requests with pagination — response body — item value request status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION

API reference · Contract 2026-10-27

SDK schema: List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION

Field	Type	Presence	Description and constraints
$	JSON	Root
$ (allOf 1)	Model	All variants apply	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION request status: APPROVED, DRAFT, REJECTED, SUBMITTED, unified request type: SPEND REQUEST
$ (allOf 2)	object	All variants apply
$ (allOf 2).existing_spend_allocation_id	JSON	Required within parent
$ (allOf 2).existing_spend_allocation_id (anyOf 1)	string	Alternative	Read only: true
$ (allOf 2).existing_spend_allocation_id (anyOf 2)	null	Alternative
$ (allOf 2).existing_spend_request	JSON	Required within parent
$ (allOf 2).existing_spend_request (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION existing spend request amount details, id, is shareable, lock date, post spend approval instance policy, spend eligibility starts at, spend frequency, unified request id, unified spend request type
$ (allOf 2).existing_spend_request (anyOf 2)	null	Alternative
$ (allOf 2).is_shareable	boolean	Required within parent
$ (allOf 2).issuance_parameters	JSON	Required within parent
$ (allOf 2).issuance_parameters (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION issuance parameters is physical, is temporary edit requested, requesting physical card Read only: true
$ (allOf 2).issuance_parameters (anyOf 2)	null	Alternative
$ (allOf 2).lifecycle_preset	JSON	Required within parent
$ (allOf 2).lifecycle_preset (anyOf 1)	string	Alternative	The request’s persisted lifecycle preset, or null when no preset is configured. Known values: SINGLE_USE
$ (allOf 2).lifecycle_preset (anyOf 2)	null	Alternative
$ (allOf 2).lock_date	JSON	Optional
$ (allOf 2).lock_date (anyOf 1)	string	Alternative	Format: date-time
$ (allOf 2).lock_date (anyOf 2)	null	Alternative
$ (allOf 2).lock_display	JSON	Required within parent
$ (allOf 2).lock_display (anyOf 1)	string	Alternative	Read only: true
$ (allOf 2).lock_display (anyOf 2)	null	Alternative
$ (allOf 2).payment_restrictions	JSON	Required within parent
$ (allOf 2).payment_restrictions (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION payment restrictions primary card enabled, reimbursements enabled, virtual card enabled Read only: true
$ (allOf 2).payment_restrictions (anyOf 2)	null	Alternative
$ (allOf 2).post_spend_approval_instance_policy	JSON	Required within parent
$ (allOf 2).post_spend_approval_instance_policy (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION post spend approval instance policy id, is default, name Read only: true
$ (allOf 2).post_spend_approval_instance_policy (anyOf 2)	null	Alternative
$ (allOf 2).prediction	JSON	Required within parent
$ (allOf 2).prediction (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION prediction explanations, feedback, overall decision, prediction id, single sentence summary, system string rationale Read only: true
$ (allOf 2).prediction (anyOf 2)	null	Alternative
$ (allOf 2).relative_lock_duration_count	JSON	Required within parent
$ (allOf 2).relative_lock_duration_count (anyOf 1)	JSON	Alternative
$ (allOf 2).relative_lock_duration_count (anyOf 1) (anyOf 1)	integer	Alternative
$ (allOf 2).relative_lock_duration_count (anyOf 1) (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (allOf 2).relative_lock_duration_count (anyOf 2)	null	Alternative
$ (allOf 2).relative_lock_duration_unit	JSON	Required within parent
$ (allOf 2).relative_lock_duration_unit (anyOf 1)	string	Alternative	Known values: DAYS, MONTHS, WEEKS, YEARS
$ (allOf 2).relative_lock_duration_unit (anyOf 2)	null	Alternative
$ (allOf 2).restricted_request_type	string	Required within parent	Known values: SPEND_ALLOCATION Default: SPEND_ALLOCATION
$ (allOf 2).resulting_spend_allocation_id	JSON	Required within parent
$ (allOf 2).resulting_spend_allocation_id (anyOf 1)	string	Alternative	Read only: true
$ (allOf 2).resulting_spend_allocation_id (anyOf 2)	null	Alternative
$ (allOf 2).spend_allocation	JSON	Required within parent
$ (allOf 2).spend_allocation (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: PROCUREMENT SPEND ALLOCATION spend request type: SPEND LIMIT, unified spend request type: PROCUREMENT SPEND ALLOCATION spend allocation id, payment restrictions, submission policy
$ (allOf 2).spend_allocation (anyOf 2)	null	Alternative
$ (allOf 2).spend_eligibility_starts_at	JSON	Optional
$ (allOf 2).spend_eligibility_starts_at (anyOf 1)	string	Alternative	Format: date-time
$ (allOf 2).spend_eligibility_starts_at (anyOf 2)	null	Alternative
$ (allOf 2).spend_request_type	string	Required within parent	Known values: SPEND_LIMIT Default: SPEND_LIMIT
$ (allOf 2).spending_restrictions	Model	Optional	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION spending restrictions Read only: true
$ (allOf 2).travel_metadata	JSON	Required within parent
$ (allOf 2).travel_metadata (anyOf 1)	Model	Alternative	Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: TRAVEL, unified request type: SPEND REQUEST, unified spend request type: TRAVEL spend request type: TRAVEL, unified spend request type: TRAVEL travel metadata Read only: true
$ (allOf 2).travel_metadata (anyOf 2)	null	Alternative
$ (allOf 2).unified_spend_request_type	string	Required within parent	Known values: SPEND_ALLOCATION Default: SPEND_ALLOCATION

Referenced models: List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION post spend approval instance policy id, is default, name, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION issuance parameters is physical, is temporary edit requested, requesting physical card, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION request status: APPROVED, DRAFT, REJECTED, SUBMITTED, unified request type: SPEND REQUEST, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION payment restrictions primary card enabled, reimbursements enabled, virtual card enabled, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION existing spend request amount details, id, is shareable, lock date, post spend approval instance policy, spend eligibility starts at, spend frequency, unified request id, unified spend request type, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: PROCUREMENT SPEND ALLOCATION spend request type: SPEND LIMIT, unified spend request type: PROCUREMENT SPEND ALLOCATION spend allocation id, payment restrictions, submission policy, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION spending restrictions, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified request type: SPEND REQUEST, unified spend request type: SPEND ALLOCATION restricted request type: SPEND ALLOCATION, spend request type: SPEND LIMIT, unified spend request type: SPEND ALLOCATION prediction explanations, feedback, overall decision, prediction id, single sentence summary, system string rationale, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: TRAVEL, unified request type: SPEND REQUEST, unified spend request type: TRAVEL spend request type: TRAVEL, unified spend request type: TRAVEL travel metadata