Ramp: Get a unified request — response body — value agreement contract type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array 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: APPROVAL_ONLY, unified_request_type: SPEND_REQUEST, unified_spend_request_type: APPROVAL_ONLY / agreement_contract_type: ONE_TIME, PERPETUAL, RENEWABLE / agreement_contract_type: ONE_TIME, PERPETUAL, RENEWABLE / sanitized_approval_steps / array / 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: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
_ramp_event_type | string | Required within parent | |
assigned_entities | array | Required within parent | |
assigned_entities[] | Model | Each item | Expand Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item assigned entities item |
completed_approval_count | JSON | Required within parent | |
completed_approval_count (anyOf 1) | JSON | Alternative | |
completed_approval_count (anyOf 1) (anyOf 1) | integer | Alternative | Satisfied eligible selected principals, including delegate credit; capped at the effective target. Default: null |
completed_approval_count (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
completed_approval_count (anyOf 2) | null | Alternative | |
displayed_event_text | string | Required within parent | |
eligible_approver_count | JSON | Required within parent | |
eligible_approver_count (anyOf 1) | JSON | Alternative | |
eligible_approver_count (anyOf 1) (anyOf 1) | integer | Alternative | Distinct eligible selected people across direct selections and groups, excluding delegate-only users. Default: null |
eligible_approver_count (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
eligible_approver_count (anyOf 2) | null | Alternative | |
event_order | JSON | Required within parent | |
event_order (anyOf 1) | integer | Alternative | |
event_order (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
event_type | string | Required within parent | Known values: NOTIFY, REQUIRE, REQUIRE_ALL, ROUND_ROBIN |
id | string | Required within parent | |
is_current_step | boolean | Required within parent | |
is_delegate | boolean | Required within parent | Default: false |
is_last_step_for_user | boolean | Required within parent | |
needs_user_action | boolean | Required within parent | |
needs_user_trigger_action | boolean | Required within parent | Default: false |
notes | JSON | Required within parent | |
notes (anyOf 1) | string | Alternative | Default: null |
notes (anyOf 2) | null | Alternative | |
raw_step_order | JSON | Required within parent | |
raw_step_order (anyOf 1) | integer | Alternative | |
raw_step_order (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
required_approval_count | JSON | Required within parent | |
required_approval_count (anyOf 1) | JSON | Alternative | |
required_approval_count (anyOf 1) (anyOf 1) | integer | Alternative | Configured approval target; execution caps it at eligible_approver_count. Default: null |
required_approval_count (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
required_approval_count (anyOf 2) | null | Alternative | |
status | string | Required within parent | Known values: ADMIN_APPROVED, ADMIN_REJECTED, APPROVED, COMPLETED, MANUALLY_SKIPPED, PENDING, REJECTED, SKIPPED, TERMINATED |
step_creator_user_id | JSON | Required within parent | |
step_creator_user_id (anyOf 1) | string | Alternative | Default: null |
step_creator_user_id (anyOf 2) | null | Alternative | |
step_date | JSON | Required within parent | |
step_date (anyOf 1) | string | Alternative | Default: null |
step_date (anyOf 2) | null | Alternative | |
substeps | array | Required within parent | |
substeps[] | Model | Each item | Expand Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item substeps item |
trigger_entity_metadata | JSON | Optional | |
trigger_entity_metadata (anyOf 1) | Model | Alternative | Expand Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item trigger entity metadata value |
trigger_entity_metadata (anyOf 2) | null | Alternative |
Referenced models: Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item substeps item, Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item assigned entities item, Get a unified request — response body — value / agreement_contract_type: ONE TIME, PERPETUAL, RENEWABLE, request status: APPROVED, DRAFT, REJECTED, SUBMITTED, spend request type: APPROVAL ONLY, unified request type: SPEND REQUEST, unified spend request type: APPROVAL ONLY agreement contract type: ONE TIME, PERPETUAL, RENEWABLE agreement contract type: ONE TIME, PERPETUAL, RENEWABLE sanitized approval steps array item trigger entity metadata value