Skip to content

Ramp: Get a unified request — response body — value request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: TRAVEL, unified request type: SPEND REQUEST, unified spend request type: TRAVEL approval chain data, attendees count, available actions, group trip, members, spend allocation outcome settings, travel metadata, trip spend allocation outcome settings spend frequency: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY

Get a unified request: response body, field value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend_request_type: TRAVEL, unified_request_type: SPEND_REQUEST, unified_spend_request_type: TRAVEL / approval_chain_data, attendees_count, available_actions, group_trip, members, spend_allocation_outcome_settings, travel_metadata, trip / spend_allocation_outcome_settings / spend_frequency: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY. 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, spend request type: TRAVEL, unified request type: SPEND REQUEST, unified spend request type: TRAVEL approval chain data, attendees count, available actions, group trip, members, spend allocation outcome settings, travel metadata, trip spend allocation outcome settings spend frequency: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY

FieldTypePresenceDescription and constraints
$objectRoot
accounting_auto_mark_ready_rule_enabledbooleanRequired within parent
accounting_rulesarrayRequired within parentRead only: true
accounting_rules[]ModelEach itemExpand 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
amount_detailsModelRequired within parentExpand 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
categories_blacklistarrayRequired within parentRead only: true
categories_blacklist[]JSONEach item
categories_blacklist[] (anyOf 1)integerAlternative
categories_blacklist[] (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
categories_whitelistarrayRequired within parentRead only: true
categories_whitelist[]JSONEach item
categories_whitelist[] (anyOf 1)integerAlternative
categories_whitelist[] (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
is_shareablebooleanRequired within parent
lock_dateJSONRequired within parent
lock_date (anyOf 1)stringAlternativeFormat: date-time
lock_date (anyOf 2)nullAlternative
payment_restrictionsModelRequired within parentExpand 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
post_spend_approval_instance_policyModelRequired within parentExpand 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
spend_eligibility_starts_atJSONRequired within parent
spend_eligibility_starts_at (anyOf 1)stringAlternativeFormat: date-time
spend_eligibility_starts_at (anyOf 2)nullAlternative
spend_frequencystringRequired within parentKnown values: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY
submission_policyModelRequired within parentExpand Get a unified request — response body — value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: TRAVEL, unified request type: SPEND REQUEST, unified spend request type: TRAVEL approval chain data, attendees count, available actions, group trip, members, spend allocation outcome settings, travel metadata, trip spend allocation outcome settings spend frequency: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY submission policy
Read only: true
vendor_blacklistarrayRequired within parentRead only: true
vendor_blacklist[]JSONEach item
vendor_blacklist[] (anyOf 1)integerAlternative
vendor_blacklist[] (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
vendor_whitelistarrayRequired within parentRead only: true
vendor_whitelist[]JSONEach item
vendor_whitelist[] (anyOf 1)integerAlternative
vendor_whitelist[] (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

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, 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, 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, Get a unified request — response body — value / request_status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: TRAVEL, unified request type: SPEND REQUEST, unified spend request type: TRAVEL approval chain data, attendees count, available actions, group trip, members, spend allocation outcome settings, travel metadata, trip spend allocation outcome settings spend frequency: ANNUAL, DAILY, MONTHLY, QUARTERLY, TERTIARY, TOTAL, WEEKLY, YEARLY submission policy, 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

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.