Skip to content

Ramp: Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option

Get a unified request: response body, field 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 / accounting_auto_mark_ready_rule_enabled, accounting_rules, approval_chain_data, approval_events, archive_date, available_actions, available_actions_v2, blank_canvas_execution_id, default_transaction_memo, members, spending_restrictions, submission_policy_id, travel_metadata, trip / accounting_rules / item / tracking_category_option. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option

FieldTypePresenceDescription and constraints
$objectRoot
additional_dataJSONRequired within parent
additional_data (anyOf 1)ModelAlternativeExpand Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option additional data account classification, cost, currency iso, description, group title, is job, is lot numbered, item receipt unapplicable, quantity decimal places, subsidiary, tax rates
additional_data (anyOf 2)nullAlternative
display_nameJSONRequired within parent
display_name (anyOf 1)stringAlternativeBase display name for the option. label, title, and subtitle are derived from this field. Prefer those instead of display_name field for display purposes.
display_name (anyOf 2)nullAlternative
display_name_prefixJSONOptional
display_name_prefix (anyOf 1)stringAlternativeOptional provider-supplied prefix used to distinguish options with the same title. Surfaces that need disambiguation should display `{display_name_prefix} - {title}`; otherwise use `title`.
display_name_prefix (anyOf 2)nullAlternative
idJSONRequired within parent
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
is_activebooleanRequired within parent
labelstringRequired within parentDisplays the code and title. This is meant to be used when there is only one line displayed in the UI.
parentModelOptionalExpand Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option parent
receiving_typesModelOptionalExpand Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option receiving types
Present only on inventory item options, in responses that look up receiving types.
Read only: true
remote_codeJSONRequired within parent
remote_code (anyOf 1)stringAlternative
remote_code (anyOf 2)nullAlternative
remote_idJSONRequired within parent
remote_id (anyOf 1)stringAlternativeThe provider-side identifier for the option. Usually ERP-owned; for universal_csv it can be updated via the PATCH endpoint.
remote_id (anyOf 2)nullAlternative
remote_namestringRequired within parentThe provider-side name for the option. Usually ERP-owned; for universal_csv it can be updated via the PATCH endpoint. Do not use this field for display purposes.
subtitleJSONRequired within parent
subtitle (anyOf 1)stringAlternativeDisplays the code, and any hierarchical relationships. This is meant to be used in conjunction with title when two lines displayed in the UI.
subtitle (anyOf 2)nullAlternative
titlestringRequired within parentThe simplest name of the option. Does not include code and hierarchical relationships. This is meant to be used in conjunction with subtitle when two lines displayed in the UI.
uuidstringRequired within parentFormat: uuid
visibilitystringRequired within parentKnown values: HIDDEN, VISIBLE

Referenced models: Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option receiving types, Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option additional data account classification, cost, currency iso, description, group title, is job, is lot numbered, item receipt unapplicable, quantity decimal places, subsidiary, tax rates, Get a unified request — response body — 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 accounting auto mark ready rule enabled, accounting rules, approval chain data, approval events, archive date, available actions, available actions v2, blank canvas execution id, default transaction memo, members, spending restrictions, submission policy id, travel metadata, trip accounting rules item tracking category option parent

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.