Ramp: Fetch a transaction — response body
Fetch a transaction: response body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a transaction — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
accounting_categories | array | Optional | [Deprecated - use accounting_field_selections instead] Accounting categories related to the transaction. Read only: true |
accounting_categories[] | Model | Each item | Expand Fetch a transaction — response body — accounting categories item |
accounting_date | JSON | Required within parent | |
accounting_date (anyOf 1) | string | Alternative | The date for the transaction for accounting purposes, in ISO8601 format. Based on the cleared date, transaction date, or a manually overridden date, depending on your accounting preferences in Ramp. Format: date-time Read only: true |
accounting_date (anyOf 2) | null | Alternative | |
accounting_field_selections | array | Optional | List of accounting fields selected to code the transaction. |
accounting_field_selections[] | Model | Each item | Expand Fetch a transaction — response body — accounting field selections item |
all_requirements_met_and_approved | boolean | Required within parent | Whether the transaction is fully approved and all cardholder requirements are met, including receipts, memos, and tracking categories. Read only: true |
amount | JSON | Optional | |
amount (anyOf 1) | number | Alternative | Deprecated. Use `entity_amount`. |
amount (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
attendees | array | Optional | List of attendees for the transaction |
attendees[] | Model | Each item | Expand Fetch a transaction — response body — attendees item |
card_holder | Model | Optional | Expand Fetch a transaction — response body — card holder Information about the card holder. |
card_id | string | Optional | Identifier of the physical or virtual card associated with the transaction. Format: uuid |
card_present | boolean | Required within parent | Whether the transaction was processed using a card present terminal. |
currency_code | string | Optional | Deprecated. Use `entity_amount.currency`. |
decline_details | Model | Optional | Expand Fetch a transaction — response body — decline details Details about a transaction decline. |
disputes | array | Optional | A list of disputes sorted in descending order by their creation time. Read only: true |
disputes[] | Model | Each item | Expand Fetch a transaction — response body — disputes item |
entity_amount | JSON | Required within parent | |
entity_amount (anyOf 1) | Model | Alternative | Expand Fetch a transaction — response body — entity amount currency, value The amount that settled to the entity, in the entity’s settlement currency. The value is in the smallest denomination of the currency (e.g. cents for USD) and is signed: refunds and credits can be negative. Null when the transaction has no valid settlement currency recorded. Read only: true |
entity_amount (anyOf 2) | null | Alternative | |
entity_id | JSON | Required within parent | |
entity_id (anyOf 1) | string | Alternative | Unique identifier of business entity associated with the transaction. Format: uuid |
entity_id (anyOf 2) | null | Alternative | |
fund_id | string | Optional | Unique identifier of the fund associated with the transaction. Returns the same value as `limit_id`. Format: uuid Read only: true |
id | string | Optional | Format: uuid |
limit_id | string | Optional | Alias of fund (`fund_id`). Unique identifier of the spend limit associated with the transaction. Returns the same value as `fund_id`. Format: uuid |
line_items | array | Optional | List of line items related to the transaction. |
line_items[] | Model | Each item | Expand Fetch a transaction — response body — line items item |
memo | JSON | Optional | |
memo (anyOf 1) | string | Alternative | |
memo (anyOf 2) | null | Alternative | |
merchant_amount | JSON | Required within parent | |
merchant_amount (anyOf 1) | Model | Alternative | Expand Fetch a transaction — response body — entity amount currency, value The original amount charged by the merchant, in the currency the merchant charged. The value is in the smallest denomination of that currency (e.g. cents) and is signed: refunds and credits can be negative. Equal to `entity_amount` when no currency conversion occurred. Null when the original amount data is unavailable or invalid. Read only: true |
merchant_amount (anyOf 2) | null | Alternative | |
merchant_category_code | string | Optional | Merchant category code is a four-digit number in ISP 18245 used to classify a business by the types of goods and services it provides. |
merchant_category_code_description | string | Optional | Description about the merchant category code. |
merchant_data | Model | Optional | Expand Fetch a transaction — response body — merchant data Purchase data associated related to a transaction provided by the merchant |
merchant_descriptor | string | Optional | A merchant descriptor is the name that appears on a customer’s bank statement when they make a purchase from that merchant. |
merchant_id | JSON | Required within parent | |
merchant_id (anyOf 1) | string | Alternative | Format: uuid |
merchant_id (anyOf 2) | null | Alternative | |
merchant_location | JSON | Required within parent | |
merchant_location (anyOf 1) | Model | Alternative | Expand Fetch a transaction — response body — merchant location city, country, postal code, state Card acceptor data such as country, city, state, and postal code if available. |
merchant_location (anyOf 2) | null | Alternative | |
merchant_name | JSON | Optional | |
merchant_name (anyOf 1) | string | Alternative | Read only: true |
merchant_name (anyOf 2) | null | Alternative | |
minor_unit_conversion_rate | JSON | Required within parent | |
minor_unit_conversion_rate (anyOf 1) | JSON | Alternative | |
minor_unit_conversion_rate (anyOf 1) (anyOf 1) | integer | Alternative | The conversion factor to convert from the integer amount to the actual currency value. Divide amount by this value to get the real currency amount. For USD, this is 100 (e.g., 12034 / 100 = 120.34 USD). Read only: true |
minor_unit_conversion_rate (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
minor_unit_conversion_rate (anyOf 2) | null | Alternative | |
network_merchant_id | JSON | Required within parent | |
network_merchant_id (anyOf 1) | string | Alternative | Network merchant identifier from the card acceptor. Read only: true |
network_merchant_id (anyOf 2) | null | Alternative | |
original_transaction_amount | JSON | Required within parent | |
original_transaction_amount (anyOf 1) | Model | Alternative | Expand Hold Bill — response body — amount the original transaction amount before the currency conversion. |
original_transaction_amount (anyOf 2) | null | Alternative | |
original_transaction_id | JSON | Required within parent | |
original_transaction_id (anyOf 1) | string | Alternative | Original transaction id for refund transactions. Read only: true |
original_transaction_id (anyOf 2) | null | Alternative | |
policy_violations | array | Optional | A list of policy violations sorted in descending order by their creation time. Read only: true |
policy_violations[] | Model | Each item | Expand Fetch a transaction — response body — policy violations item |
receipt_affidavit | JSON | Optional | |
receipt_affidavit (anyOf 1) | string | Alternative | Read only: true |
receipt_affidavit (anyOf 2) | null | Alternative | |
receipts | array | Optional | Receipts listed in ascending order by their creation time, related to the transaction. Read only: true |
receipts[] | string | Each item | Format: uuid |
requires_accounting_vendor_creation_to_sync | boolean | Optional | Whether the integrator must create an accounting vendor and code it to this transaction before syncing. True when the connection has transaction_accounting_vendor_creation_on_sync_enabled=true and the transaction has no vendor accounting field selection. Omitted when transaction_accounting_vendor_creation_on_sync_enabled=false. Read only: true |
settlement_date | string | Optional | Time when funds were moved for a transaction, in ISO8601 format. Format: date-time |
sk_category_id | JSON | Required within parent | |
sk_category_id (anyOf 1) | JSON | Alternative | |
sk_category_id (anyOf 1) (anyOf 1) | integer | Alternative | Ramp category code. Known values: 1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 2, 20, 21, 23, 24, 25, 26, 27, 28, 29, 3, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 4, 40, 41, 42, 43, 44, 5, 6, 7, 8, 9 Read only: true |
sk_category_id (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
sk_category_id (anyOf 2) | null | Alternative | |
sk_category_name | JSON | Required within parent | |
sk_category_name (anyOf 1) | string | Alternative | Ramp category name. Read only: true |
sk_category_name (anyOf 2) | null | Alternative | |
spend_program_id | string | Optional | Unique identifier of the spend program from which this limit was issued. Format: uuid |
state | string | Optional | transaction state. Known values: ALL, CLEARED, COMPLETION, DECLINED, ERROR, PENDING, PENDING_INITIATION |
statement_id | string | Optional | Statement ID associated with the transaction if one is available. Format: uuid |
sync_status | string | Required within parent | Known values: NOT_SYNC_READY, SYNCED, SYNC_READY Read only: true |
synced_at | JSON | Required within parent | |
synced_at (anyOf 1) | string | Alternative | Time when transaction has been synced, in ISO8601 format. Will be None if the transaction is not synced. Format: date-time |
synced_at (anyOf 2) | null | Alternative | |
trip_id | JSON | Required within parent | |
trip_id (anyOf 1) | string | Alternative | Trip ID associated with the transaction if one is available. Format: uuid |
trip_id (anyOf 2) | null | Alternative | |
trip_name | JSON | Required within parent | |
trip_name (anyOf 1) | string | Alternative | Trip name associated with the transaction if one is available. |
trip_name (anyOf 2) | null | Alternative | |
updated_at | JSON | Required within parent | |
updated_at (anyOf 1) | string | Alternative | Approximate transaction updated timestamp used by the `updated_after` filter. Computed as the latest of user transaction time, settlement time, and transaction interaction state update time. Format: date-time Read only: true |
updated_at (anyOf 2) | null | Alternative | |
user_transaction_time | string | Optional | Time when the transaction was created by the user, in ISO8601 format. Format: date-time |
Referenced models: Fetch a transaction — response body — accounting categories item, Fetch a transaction — response body — merchant location city, country, postal code, state, Fetch a transaction — response body — attendees item, Fetch a transaction — response body — card holder, Fetch a transaction — response body — disputes item, Fetch a transaction — response body — policy violations item, Fetch a transaction — response body — entity amount currency, value, Fetch a transaction — response body — accounting field selections item, Fetch a transaction — response body — decline details, Fetch a transaction — response body — line items item, Fetch a transaction — response body — merchant data, Hold Bill — response body — amount