Skip to content

Ramp: Get a unified request — response body — value agreement contract type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER agreement contract type: ONE TIME, PERPETUAL, RENEWABLE purchase order, purchase order detail, total amount details in business default currency purchase order purchase order line item log entries item

Get a unified request: response body, field value / agreement_contract_type: ONE_TIME, PERPETUAL, RENEWABLE, request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend_request_type: PURCHASE_ORDER, unified_request_type: SPEND_REQUEST, unified_spend_request_type: PURCHASE_ORDER / agreement_contract_type: ONE_TIME, PERPETUAL, RENEWABLE / purchase_order, purchase_order_detail, total_amount_details_in_business_default_currency / purchase_order / purchase_order_line_item_log_entries / item. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER agreement contract type: ONE TIME, PERPETUAL, RENEWABLE purchase order, purchase order detail, total amount details in business default currency purchase order purchase order line item log entries item

FieldTypePresenceDescription and constraints
$objectRoot
accounting_tracking_category_selectionsarrayRequired within parentRead only: true
accounting_tracking_category_selections[]ModelEach itemExpand Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER agreement contract type: ONE TIME, PERPETUAL, RENEWABLE purchase order, purchase order detail, total amount details in business default currency purchase order accounting tracking category selections item
amountJSONRequired within parent
amount (anyOf 1)numberAlternative
amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
custom_field_valuesarrayRequired within parentRead only: true
custom_field_values[]ModelEach itemExpand Fetch a purchase order — response body — line items item custom field values item
descriptionJSONRequired within parent
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
due_dateJSONRequired within parent
due_date (anyOf 1)stringAlternativeFormat: date
due_date (anyOf 2)nullAlternative
end_dateJSONRequired within parent
end_date (anyOf 1)stringAlternativeFormat: date
end_date (anyOf 2)nullAlternative
existing_purchase_order_line_item_uuidJSONRequired within parent
existing_purchase_order_line_item_uuid (anyOf 1)stringAlternativeFormat: uuid
existing_purchase_order_line_item_uuid (anyOf 2)nullAlternative
idstringRequired within parentRead only: true
line_item_typestringRequired within parentKnown values: EXPENSE, ITEM
quantityJSONRequired within parent
quantity (anyOf 1)JSONAlternative
quantity (anyOf 1) (anyOf 1)numberAlternative
quantity (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
quantity (anyOf 2)nullAlternative
receiving_typestringOptionalHow the line is received: by quantity or by amount.
Known values: by_amount, by_quantity
start_dateJSONRequired within parent
start_date (anyOf 1)stringAlternativeFormat: date
start_date (anyOf 2)nullAlternative
tax_amountsarrayRequired within parentTax amounts applied to this purchase order line item.
Read only: true
tax_amounts[]ModelEach itemExpand Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER agreement contract type: ONE TIME, PERPETUAL, RENEWABLE purchase order, purchase order detail, total amount details in business default currency purchase order tax lines item
total_amountJSONRequired within parent
total_amount (anyOf 1)numberAlternative
total_amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
unit_priceJSONRequired within parent
unit_price (anyOf 1)JSONAlternative
unit_price (anyOf 1) (anyOf 1)numberAlternative
unit_price (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
unit_price (anyOf 2)nullAlternative
unit_quantityJSONRequired within parent
unit_quantity (anyOf 1)JSONAlternative
unit_quantity (anyOf 1) (anyOf 1)numberAlternativeDeprecated: read from quantity field instead
Read only: true
unit_quantity (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
unit_quantity (anyOf 2)nullAlternative
uuidstringRequired within parentRead only: true
withholding_rateJSONOptional
withholding_rate (anyOf 1)stringAlternativeRetainage withholding rate for the line item
Format: decimal
withholding_rate (anyOf 2)nullAlternative

Referenced models: Fetch a purchase order — response body — line items item custom field values item, Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER agreement contract type: ONE TIME, PERPETUAL, RENEWABLE purchase order, purchase order detail, total amount details in business default currency purchase order accounting tracking category selections item, Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER agreement contract type: ONE TIME, PERPETUAL, RENEWABLE purchase order, purchase order detail, total amount details in business default currency purchase order tax lines item

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.