Ramp: Fetch a vendor agreement — response body — pending spend requests item
Fetch a vendor agreement: response body, field pending_spend_requests / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a vendor agreement — response body — pending spend requests item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
approval_chain_metadata | Model | Required within parent | Expand Fetch a vendor agreement — response body — pending spend requests item approval chain metadata |
can_view | boolean | Required within parent | Whether the current user has permission to view this spend request. |
created_at | string | Required within parent | Format: date-time |
created_by | string | Required within parent | Format: uuid |
currency | string | Required within parent | Currency code for the spend request amounts. |
display_name | JSON | Required within parent | |
display_name (anyOf 1) | string | Alternative | Display name of the spend request. Default: null |
display_name (anyOf 2) | null | Alternative | |
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 | |
request_status | string | Required within parent | Known values: APPROVED, DRAFT, REJECTED, SUBMITTED |
source | string | Required within parent | Known values: EXPANSION_REQUEST, RENEWAL, REQUEST_APPROVAL, REQUEST_LINKED_TO_AGREEMENT |
spend_intent_name | JSON | Required within parent | |
spend_intent_name (anyOf 1) | string | Alternative | Name of the associated spend intent. Default: null |
spend_intent_name (anyOf 2) | null | Alternative | |
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. |
Referenced models: Fetch a vendor agreement — response body — pending spend requests item approval chain metadata, Hold Bill — response body — amount