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 spending restrictions
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 / spending_restrictions. 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 spending restrictions
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
amount | JSON | Optional | |
amount (anyOf 1) | number | Alternative | |
amount (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
amount_details | JSON | Required within parent | |
amount_details (anyOf 1) | Model | Alternative | Expand List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER request status: APPROVED, DRAFT, REJECTED, SUBMITTED, unified request type: SPEND REQUEST amount details, total amount details amount details Read only: true |
amount_details (anyOf 2) | null | Alternative | |
categories_blacklist | array | Optional | |
categories_blacklist[] | JSON | Each item | |
categories_blacklist[] (anyOf 1) | integer | Alternative | |
categories_blacklist[] (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
categories_whitelist | array | Optional | |
categories_whitelist[] | JSON | Each item | |
categories_whitelist[] (anyOf 1) | integer | Alternative | |
categories_whitelist[] (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
currency | Model | Optional | Expand 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 spending restrictions currency |
interval | string | Required within parent | Known values: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY |
lock_date | JSON | Optional | |
lock_date (anyOf 1) | string | Alternative | Format: date-time |
lock_date (anyOf 2) | null | Alternative | |
lock_display | JSON | Optional | |
lock_display (anyOf 1) | string | Alternative | |
lock_display (anyOf 2) | null | Alternative | |
relative_lock_duration_count | JSON | Optional | |
relative_lock_duration_count (anyOf 1) | JSON | Alternative | |
relative_lock_duration_count (anyOf 1) (anyOf 1) | integer | Alternative | |
relative_lock_duration_count (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
relative_lock_duration_count (anyOf 2) | null | Alternative | |
relative_lock_duration_unit | JSON | Optional | |
relative_lock_duration_unit (anyOf 1) | string | Alternative | Known values: DAYS, MONTHS, WEEKS, YEARS |
relative_lock_duration_unit (anyOf 2) | null | Alternative | |
start_date | JSON | Optional | |
start_date (anyOf 1) | string | Alternative | Format: date-time |
start_date (anyOf 2) | null | Alternative | |
transaction_amount_limit | JSON | Optional | |
transaction_amount_limit (anyOf 1) | JSON | Alternative | |
transaction_amount_limit (anyOf 1) (anyOf 1) | number | Alternative | |
transaction_amount_limit (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
transaction_amount_limit (anyOf 2) | null | Alternative | |
vendor_blacklist | array | Optional | |
vendor_blacklist[] | JSON | Each item | |
vendor_blacklist[] (anyOf 1) | integer | Alternative | |
vendor_blacklist[] (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
vendor_whitelist | array | Optional | |
vendor_whitelist[] | JSON | Each item | |
vendor_whitelist[] (anyOf 1) | integer | Alternative | |
vendor_whitelist[] (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
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 spending restrictions currency, List unified requests with pagination — response body — item / value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: PURCHASE ORDER, unified request type: SPEND REQUEST, unified spend request type: PURCHASE ORDER request status: APPROVED, DRAFT, REJECTED, SUBMITTED, unified request type: SPEND REQUEST amount details, total amount details amount details