# List Transfers

Retrieve a list of .

For details on how to query endpoints using the available parameters, see Query Parameters.


Endpoint: GET /transfers
Security: BasicAuth

## Query parameters:

  - `after_cursor` (string)
    Return every resource created after the cursor value.

  - `amount.gt` (integer)
    Filter by an amount greater than.
    Example: 100

  - `amount.gte` (integer)
    Filter by an amount greater than or equal.
    Example: 100

  - `amount.lt` (integer)
    Filter by an amount less than.
    Example: 100

  - `amount.lte` (integer)
    Filter by an amount less than or equal.
    Example: 100

  - `amount` (integer)
    Filter by an amount equal to the given value.
    Example: 100

  - `bank_return_reason_code` (string)
    Filter bank reversals by ACH Return Code. Use comma-separation to query for multiple values.
    Example: "R03,R07"

  - `before_cursor` (string)
    Return every resource created before the cursor value.

  - `buyer_business_name` (string)
    Filter by the Buyer Identity's business name (exact match).
    Example: "Finix%20Flowers"

  - `buyer_business_name.like` (string)
    Filter by the Buyer Identity's business name (partial match).
    Example: "finix"

  - `buyer_doing_business_as` (string)
    Filter by the Buyer Identity's Doing Business As (exact match).
    Example: "Finix%20Flowers"

  - `buyer_doing_business_as.like` (string)
    Filter by the Buyer Identity's Doing Business As (partial match).
    Example: "finix"

  - `buyer_identity_first_name` (string)
    Filter by the Buyer Identity's first name (exact match).
    Example: "John"

  - `buyer_identity_first_name.like` (string)
    Filter by the Buyer Identity's first name (partial match).
    Example: "joh"

  - `buyer_identity_id` (string)
    Filter by the Buyer Identity's ID.
    Example: "ID6Qm3BQUxGFcCWZ185TS8sn"

  - `buyer_identity_last_name` (string)
    Filter by the Buyer Identity's last name (exact match).
    Example: "Doe"

  - `buyer_identity_last_name.like` (string)
    Filter by the Buyer Identity's last name (partial match).
    Example: "do"

  - `buyer_identity_name` (string)
    Filter by the Buyer Identity's full personal name (exact match).
    Example: "John%20Doe"

  - `buyer_identity_name.like` (string)
    Filter by the Buyer Identity's full personal name (partial match).
    Example: "john"

  - `created_at.gte` (string)
    Filter where  is after the given date.
    Example: "2022-09-27T11:21:23"

  - `created_at.lte` (string)
    Filter where  is before the given date.
    Example: "2026-09-27T11:21:23"

  - `currency` (string)
    Filter by the currency of the resource.
    Example: "USD"

  - `device` (string)
    Filter by the device's ID.
    Example: "DVsEanpBtsAVvCHbNXkFaH6f"

  - `id` (string)
    Filter by .

  - `idempotency_id` (string)
    Filter by Idempotency ID.
    Example: "15d32948-c766-4033-8d87-dfbdcabcbc5c"

  - `instrument_account_last4` (string)
    For  Payment Instruments, filter by the last-4 digits of the bank account number (i.e., from the Payment Instrument's ).
    Example: 1234

  - `instrument_bin` (string)
    For  Payment Instruments, filter by the first-6 digits of the card's number (i.e., the Payment Instrument's ).
    Example: 601100

  - `instrument_brand_type` (string)
    For  Payment Instruments, filter by the card's .
    Example: "MASTERCARD"

  - `instrument_card_last4` (string)
    For  Payment Instruments, filter by the last-4 digits of the card's number (i.e., the Payment Instrument's ).
    Example: 4242

  - `instrument_issuer_country` (string)
    For  Payment Instruments, filter by the card's issuing country (i.e., the Payment Instrument's ). Use comma-separation to query for multiple values.
    Example: "USA,CAN"

  - `instrument_name` (string)
    Filter by the Payment Instrument's  (exact match).
    Example: "Business%20Card"

  - `instrument_type` (string)
    Filter by the Payment Instrument's .
    Enum: "PAYMENT_CARD", "BANK_ACCOUNT"

  - `limit` (integer)
    The numbers of items to return.
    Example: 10

  - `merchant_id` (string)
    Filter by the Merchant's ID (i.e., the Transfer's ).
    Example: "MUtAWVfXkf149BVi2cL2HvPU"

  - `merchant_identity_id` (string)
    Filter by the Merchant's Identity ID (i.e., the Transfer's ).
    Example: "IDtX3ciHPq2DDquCQJRwj7VW"

  - `merchant_identity_name` (string)
    Filter by the Merchant's name (i.e., the Merchant's ).
    Example: "Finix%20Flowers"

  - `merchant_mid` (string)
    Filter by the Merchant's Merchant Identification Number (MID) (i.e., the Merchant's ).
    Example: "FNXkitpwdmgMJ8Vz9FxKBCSza"

  - `merchant_processor_id` (string)
    Filter by the Merchant's processor (i.e., the Merchant's ).
    Example: "DUMMY_V1"

  - `ready_to_settle_at.gte` (string)
    Filter where  is after the given date. Only available on . For more details, see Versioning.
    Example: "2023-06-28T00:00:00"

  - `ready_to_settle_at.lte` (string)
    Filter where  is before the given date. Only available on . For more details, see Versioning.
    Example: "2023-06-28T00:00:00"

  - `state` (string)
    Filter by the transfer's state.
    Enum: "ALL", "CANCELED", "FAILED", "PENDING", "RETURNED", "SUCCEEDED"

  - `tags.key` (string)
    Filter by the tag's key. For more information, see Tags.
    Example: "card_type"

  - `tags.value` (string)
    Filter by the tag's value. For more information, see Tags.
    Example: "business_card"

  - `trace_id` (string)
    Filter by .
    Example: "021fc4ed-f0a8-4932-820c-b22b542526f8"

  - `type` (string)
    Filter by  type.
    Enum: "ALL", "DEBIT", "CREDIT", "REVERSAL", "SETTLEMENT"

  - `updated_at.gte` (string)
    Filter where  is after the given date.
    Example: "2022-09-27T11:21:23"

  - `updated_at.lte` (string)
    Filter where  is before the given date.
    Example: "2026-09-27T11:21:23"

## Header parameters:

  - `Finix-Version` (string)
    Specify the API version of your request. For more details, see Versioning.
    Example: "2022-02-01"

## Response 200 fields (application/json):

  - `page` (object)
    Details the page that's returned.

  - `page.limit` (integer)
    The number of entries to return.

  - `page.next_cursor` (string,null)
    The cursor to use for the next page of results.

  - `_embedded` (object)

  - `_embedded.transfers` (array)

  - `_embedded.transfers.id` (string)
    The ID of the resource.

  - `_embedded.transfers.created_at` (string)
    Timestamp of when the object was created.

  - `_embedded.transfers.updated_at` (string)
    Timestamp of when the object was last updated.

  - `_embedded.transfers.additional_buyer_charges` (object,null)
    Details about any [Buyer Charges](../../../../guides/online-payments/payment-features/buyer-charges) included in the . The buyer charges are mutually exclusive.

  - `_embedded.transfers.additional_buyer_charges.convenience_amount` (integer,null)
    A convenience fee to charge the buyer for the transaction. This object property is mutually exclusive.

  - `_embedded.transfers.additional_buyer_charges.rent_surcharge_amount` (integer,null)
    A rent surcharge to charge the buyer for the transaction. This object property is mutually exclusive.

  - `_embedded.transfers.additional_buyer_charges.surcharge_amount` (integer,null)
    A surcharge amount to charge the buyer for the transaction. This object property is mutually exclusive.

  - `_embedded.transfers.additional_healthcare_data` (object,null)

  - `_embedded.transfers.additional_healthcare_data.clinic_amount` (integer,null)
    A clinic or other qualified medical amount for the transaction.

  - `_embedded.transfers.additional_healthcare_data.dental_amount` (integer,null)
    The dental amount for the transaction.

  - `_embedded.transfers.additional_healthcare_data.prescription_amount` (integer,null)
    The prescription/RX amount for the transaction.

  - `_embedded.transfers.additional_healthcare_data.vision_amount` (integer,null)
    The vision/optical amount for the transaction.

  - `_embedded.transfers.additional_purchase_data` (object,null)
    Additional information about the purchase. Used for [Level 2 and Level 3 Processing](/guides/online-payments/payment-features/level-2-level-3-processing).

  - `_embedded.transfers.additional_purchase_data.customer_reference_number` (string, required)
    The customer reference for the purchase (max 17 characters).

  - `_embedded.transfers.additional_purchase_data.customs_duty_amount` (integer)
    The duty in cents on the total purchase amount for the order.

  - `_embedded.transfers.additional_purchase_data.destination_country_code` (string)
    The ISO country code of the order destination.

  - `_embedded.transfers.additional_purchase_data.destination_postal_code` (string)
    The postal code of the order destination (10 characters).

  - `_embedded.transfers.additional_purchase_data.discount_amount` (integer)
    The amount in cents of the discount for the order.

  - `_embedded.transfers.additional_purchase_data.invoice_reference_number` (string)
    The order's invoice number (max 15 characters).

  - `_embedded.transfers.additional_purchase_data.order_date` (object)

  - `_embedded.transfers.additional_purchase_data.order_date.day` (integer)
    Day of purchase (between 1 and 31).

  - `_embedded.transfers.additional_purchase_data.order_date.month` (integer)
    Month of purchase (between 1 and 12).

  - `_embedded.transfers.additional_purchase_data.order_date.year` (integer)
    Year of purchase (4-digit).

  - `_embedded.transfers.additional_purchase_data.sales_tax` (integer, required)
    - Total aggregate tax amount in cents for the entire purchase. Field is automatically calculated if you pass in the itemized tax amounts. 
- For non-taxable transactions either set  to 0 or omit from payload and also set  to .
- Request must align so  +  = .

  - `_embedded.transfers.additional_purchase_data.sales_tax_finix_generated` (integer,null)

  - `_embedded.transfers.additional_purchase_data.ship_from_postal_code` (string)
    The postal code from where order is shipped (10 characters).

  - `_embedded.transfers.additional_purchase_data.shipping_amount` (integer)
    The shipping cost in cents for the order.

  - `_embedded.transfers.additional_purchase_data.tax_exempt` (boolean)
    - For tax exempt purchases set to .
- If set to , request can't include .

  - `_embedded.transfers.additional_purchase_data.item_data` (array)
    Additional information about the transaction. Used for Level 2 and Level 3 Processing.

  - `_embedded.transfers.additional_purchase_data.item_data.amount_excluding_sales_tax` (integer)
    - Total cost of the line item in cents, excluding tax.
- Must align with  so  +  = .

  - `_embedded.transfers.additional_purchase_data.item_data.amount_including_sales_tax` (integer)
    - Total cost of the line item in cents, including tax.
- Must align with  so  +  = .

  - `_embedded.transfers.additional_purchase_data.item_data.commodity_code` (string)
    A commodity code is a numeric code representing a particular product or service as defined by the National Institute of Governmental Purchasing. The code can be 3, 5, 7, or 11 digits in length. The longer the code the more granular the description of the product/service. (max 12 characters).

  - `_embedded.transfers.additional_purchase_data.item_data.cost_per_unit` (integer)
    The price in cents of one unit of the item purchased.

  - `_embedded.transfers.additional_purchase_data.item_data.item_description` (string)
    Required when  is supplied (max 25 characters).

  - `_embedded.transfers.additional_purchase_data.item_data.item_discount_amount` (integer)
    Item discount amount in cents

  - `_embedded.transfers.additional_purchase_data.item_data.merchant_product_code` (string)
    Merchant defined product code (max 12 characters).

  - `_embedded.transfers.additional_purchase_data.item_data.quantity` (integer)
    The number of items purchased. Must be greater than 0.

  - `_embedded.transfers.additional_purchase_data.item_data.unit_of_measure` (string)
    The unit of measure of the purchased item (max 3 characters).

  - `_embedded.transfers.address_verification` (string,null)
    Details the results of the address verification checks.
    Enum: "POSTAL_CODE_AND_STREET_MATCH", "STREET_MATCH", "POSTAL_CODE_MATCH", "NO_ADDRESS", "NO_MATCH", "NOT_SUPPORTED", "UNKNOWN"

  - `_embedded.transfers.amount` (integer)
    The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

  - `_embedded.transfers.amount_requested` (integer)
    Details the  that was requested to get debited from the  when the transaction was created.

  - `_embedded.transfers.application` (string)
    ID of the  associated with the resource.

  - `_embedded.transfers.bank_return_details` (object,null)
    Details about a transfer that was returned and was unable to be processed. Only present when  is

  - `_embedded.transfers.bank_return_details.reason_code` (string)
    Return response code from the bank.

  - `_embedded.transfers.bank_return_details.reason_message` (string)
    Detailed message explaining reason for the return.

  - `_embedded.transfers.bank_return_details.reason_title` (string)
    Short message categorizing reason for the return.

  - `_embedded.transfers.card_present_details` (object,null)
    Details needed to process card present transactions.

  - `_embedded.transfers.card_present_details.approval_code` (string,null)
    Unique ID used to identify the approval of the .

  - `_embedded.transfers.card_present_details.brand` (string,null)
    The brand of the card saved in the .

  - `_embedded.transfers.card_present_details.emv_data` (object,null)
    Encrypted card data used to process the transaction.

  - `_embedded.transfers.card_present_details.emv_data.application_identifier` (string)
    ID of the application used in the transaction. Tag 9F06 from the EMVCo standard.

  - `_embedded.transfers.card_present_details.emv_data.application_label` (string)
    EMV application label. Tag 50 from the EMVCo standard.

  - `_embedded.transfers.card_present_details.emv_data.application_preferred_name` (string,null)
    EMV application label with formatting (if provided). Tag 9F12 from the EMVCo standard.

  - `_embedded.transfers.card_present_details.emv_data.application_transaction_counter` (string)
    Transaction number for the EMV application. Tag 9F36 from the EMVCo standard.

  - `_embedded.transfers.card_present_details.emv_data.cryptogram` (string)
    Cryptogram returned by the card. Tag 9F26 of the EMVCo standard.

  - `_embedded.transfers.card_present_details.emv_data.issuer_code_table_index` (string,null)
    The alphabet code table (according to ISO 8859) used by the EMV application (if provided). Tag 9F11.

  - `_embedded.transfers.card_present_details.emv_data.pin_verified` (boolean)
    Whether the cardholder's PIN number was verified.

  - `_embedded.transfers.card_present_details.emv_data.tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

  - `_embedded.transfers.card_present_details.entry_mode` (string,null)
    Details of the card payment method used to process the transaction.

The possible enums are:

- UNKNOWN - The method by which the payment card was used is unknown.
- SWIPED - The card was swiped through a POS terminal. 
- MANUAL_KEY_ENTRY - The cardholder's information was entered manually into a POS terminal.
- CONTACTLESS - The payment was made by tapping a card on a POS terminal.
- CHIP_ENTRY - The payment card was inserted into a card reader.
    Enum: "UNKNOWN", "SWIPED", "MANUAL_KEY_ENTRY", "CONTACTLESS", "CHIP_ENTRY"

  - `_embedded.transfers.card_present_details.masked_account_number` (string,null)
    Last four digits of the bank account number.

  - `_embedded.transfers.card_present_details.name` (string,null)
    The name of the bank account or card owner.

  - `_embedded.transfers.card_present_details.payment_type` (string)
    The type of  used in the transaction (or the original payment).

  - `_embedded.transfers.currency` (string)
    ISO 4217 3-letter currency code.
    Enum: "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "CNY", "COP", "COU", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRO", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLL", "SOS", "SRD", "SSP", "STD", "SVC", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "USN", "UYI", "UYU", "UZS", "VEF", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "XSU", "XTS", "XUA", "XXX", "YER", "ZAR", "ZMW", "ZWL"

  - `_embedded.transfers.destination` (string,null)
    The ID of the destination.

  - `_embedded.transfers.device` (string)
    The ID of the  resource the  was created under.

  - `_embedded.transfers.externally_funded` (string)
    Details if the  will be settled externally by card processors.

  - `_embedded.transfers.failure_code` (string,null)
    The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see [Failure Codes](../../../../additional-resources/developers/implementation-and-testing/error-codes/#failure-codes).

  - `_embedded.transfers.failure_message` (string,null)
    A human-readable description of why the transaction was declined. This will also include a suggestion on how to complete the payment.

  - `_embedded.transfers.fee` (integer)
    The minimum amount of the  you'd like to collect as your fee in cents. Defaults to zero (must be less than or equal to the ).
- If the fees applied by the 'Fee Profile' are * than the value passed in 'fee', 'fee' will not be applied and have no effect.
- If the fees applied by the 'Fee Profile' are * than the value passed in 'fee', an additional fee is be applied, in addition to the fees generated by the .
    - The additional fee is equal to the difference between the value passed in 'fee' and the fees generated by the .
fraud_session_id:

  - `_embedded.transfers.fee_type` (string)
    Details the type of fee if the  includes a .
    Enum: "ACH_BASIS_POINTS", "ACH_CREDIT_RETURN_FIXED_FEE", "ACH_DEBIT_RETURN_FIXED_FEE", "ACH_FIXED", "ACH_MAX_FIXED", "ACH_NOTICE_OF_CHANGE_CREDIT_FIXED", "ACH_NOTICE_OF_CHANGE_DEBIT_FIXED", "AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS", "AMERICAN_EXPRESS_BASIS_POINTS", "AMERICAN_EXPRESS_FIXED", "AMERICAN_EXPRESS_INTERCHANGE", "ANCILLARY_FIXED_FEE_PRIMARY", "ANCILLARY_FIXED_FEE_SECONDARY", "APPLICATION_FEE", "CARD_BASIS_POINTS", "CARD_FIXED", "CARD_INTERCHANGE", "CUSTOM", "DINERS_CLUB_BASIS_POINTS", "DINERS_CLUB_FIXED", "DINERS_CLUB_INTERCHANGE", "DISCOVER_ASSESSMENT_BASIS_POINTS", "DISCOVER_BASIS_POINTS", "DISCOVER_DATA_USAGE_FIXED", "DISCOVER_FIXED", "DISCOVER_INTERCHANGE", "DISCOVER_NETWORK_AUTHORIZATION_FIXED", "DISPUTE_FIXED_FEE", "DISPUTE_INQUIRY_FIXED_FEE", "EFT_MAX_FIXED", "JCB_BASIS_POINTS", "JCB_FIXED", "JCB_INTERCHANGE", "MASTERCARD_ACQUIRER_FEE_BASIS_POINTS", "MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS", "MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS", "MASTERCARD_BASIS_POINTS", "MASTERCARD_FIXED", "MASTERCARD_INTERCHANGE", "QUALIFIED_TIER_BASIS_POINTS_FEE", "QUALIFIED_TIER_FIXED_FEE", "SETTLEMENT_FUNDING_TRANSFER_ACH_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_ACH_CREDIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_ACH_DEBIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_ACH_FIXED", "SETTLEMENT_FUNDING_TRANSFER_ACH_MAX_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_EFT_CREDIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_DEBIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_MAX_FIXED", "SETTLEMENT_FUNDING_TRANSFER_INSTANT_PAYOUT_CARD_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_INSTANT_PAYOUT_CARD_FIXED", "SETTLEMENT_FUNDING_TRANSFER_INSTANT_PAYOUT_CARD_MAX_FIXED", "SETTLEMENT_FUNDING_TRANSFER_NOC_CREDIT_FIXED", "SETTLEMENT_FUNDING_TRANSFER_NOC_DEBIT_FIXED", "SETTLEMENT_FUNDING_TRANSFER_SAME_DAY_ACH_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_SAME_DAY_ACH_FIXED", "SETTLEMENT_FUNDING_TRANSFER_SAME_DAY_ACH_MAX_FIXED", "SETTLEMENT_V2_TRANSFER", "SUBSCRIPTION_ACH_BASIS_POINTS", "SUBSCRIPTION_ACH_FIXED", "SUBSCRIPTION_ACH_MAX_FIXED", "SUBSCRIPTION_CARD_BASIS_POINTS", "SUBSCRIPTION_CARD_FIXED", "SUBSCRIPTION_EFT_BASIS_POINTS", "SUBSCRIPTION_EFT_FIXED", "SUBSCRIPTION_EFT_MAX_FIXED", "SUPPLEMENTAL_FEE_FIXED", "VISA_ACQUIRER_PROCESSING_FIXED", "VISA_ASSESSMENT_BASIS_POINTS", "VISA_BASE_II_CREDIT_VOUCHER_FIXED", "VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED", "VISA_BASIS_POINTS", "VISA_CREDIT_VOUCHER_FIXED", "VISA_FIXED", "VISA_INTERCHANGE", "VISA_KILOBYTE_ACCESS_FIXED"

  - `_embedded.transfers.fee_profile` (string)
    The ID of the  that will be used for calculating fees for this transfer.
    Example: "FPxxxxxxxxx"

  - `_embedded.transfers.idempotency_id` (string)
    Pass any randomly generated or internal ID to [idempotently](/api/section/idempotent-requests) identify the .

  - `_embedded.transfers.merchant` (string)
    The ID of the  resource the  was created under.
    Example: "MUxxxxxxxxxxxxxxxxxxxxxxx"

  - `_embedded.transfers.merchant_identity` (string)
    The ID of  resource used by the  the  was created under.
    Example: "IDxxxxxxxxxxxxxxxxxxxxxxxx"

  - `_embedded.transfers.operation_key` (string,null)
    Details the operation that's performed in the transaction.
    Enum: "PUSH_TO_CARD", "PULL_FROM_CARD", "CARD_PRESENT_DEBIT", "CARD_PRESENT_UNREFERENCED_REFUND", "SALE", "UNREFERENCED_REFUND", "MERCHANT_CREDIT_ADJUSTMENT", "MERCHANT_DEBIT_ADJUSTMENT", "CARD_PRESENT_AUTHORIZATION", "STANDARD_MERCHANT_FUNDING_PUSH_TO_ACH", "STANDARD_MERCHANT_FUNDING_PUSH_TO_SAME_DAY_ACH", "STANDARD_MERCHANT_FUNDING_PUSH_TO_CARD", "INSTANT_MERCHANT_FUNDING_PUSH_TO_ACH", "INSTANT_MERCHANT_FUNDING_PUSH_TO_FED_NOW", "INSTANT_MERCHANT_FUNDING_PUSH_TO_SAME_DAY_ACH", "INSTANT_MERCHANT_FUNDING_PUSH_TO_CARD", "STANDARD_MERCHANT_FUNDING_PULL_FROM_ACH", "STANDARD_MERCHANT_FUNDING_PULL_FROM_SAME_DAY_ACH", "STANDARD_MERCHANT_FUNDING_PULL_FROM_CARD", "INSTANT_MERCHANT_FUNDING_PULL_FROM_ACH", "INSTANT_MERCHANT_FUNDING_PULL_FROM_FED_NOW", "INSTANT_MERCHANT_FUNDING_PULL_FROM_SAME_DAY_ACH", "STANDARD_APPLICATION_FUNDING_PUSH_TO_ACH", "STANDARD_APPLICATION_FUNDING_PUSH_TO_SAME_DAY_ACH", "STANDARD_APPLICATION_FUNDING_PUSH_TO_CARD", "INSTANT_APPLICATION_FUNDING_PUSH_TO_ACH", "INSTANT_APPLICATION_FUNDING_PUSH_TO_FED_NOW", "INSTANT_APPLICATION_FUNDING_PUSH_TO_SAME_DAY_ACH", "INSTANT_APPLICATION_FUNDING_PUSH_TO_CARD", "STANDARD_APPLICATION_FUNDING_PULL_FROM_ACH", "STANDARD_APPLICATION_FUNDING_PULL_FROM_SAME_DAY_ACH", "STANDARD_APPLICATION_FUNDING_PULL_FROM_CARD", "INSTANT_APPLICATION_FUNDING_PULL_FROM_CARD", "INSTANT_APPLICATION_FUNDING_PULL_FROM_ACH", "INSTANT_APPLICATION_FUNDING_PULL_FROM_FED_NOW", "INSTANT_APPLICATION_FUNDING_PULL_FROM_SAME_DAY_ACH"

  - `_embedded.transfers.parent_transfer` (string,null)
    - ID of the original parent  where the transaction occurred.
- Only is present when  is  or .

  - `_embedded.transfers.parent_transfer_trace_id` (string,null)
    - The  of the original parent  where the transaction occurred.
- Only visible when  is  or .

  - `_embedded.transfers.messages` (array)
    Message field that provides additional details.

  - `_embedded.transfers.raw` (any)
    Raw response from the processor.

  - `_embedded.transfers.ready_to_settle_at` (string,null)
    The timestamp indicating when the  is ready to be settled.

  - `_embedded.transfers.receipt_last_printed_at` (string,null)
    Timestamp when the receipt was last printed.

  - `_embedded.transfers.security_code_verification` (string)
    Details the results of the Card Verification Code check.
    Enum: "MATCHED", "UNKNOWN", "UNMATCHED"

  - `_embedded.transfers.source` (string,null)
    The ID of the  that will be debited and performing the .

  - `_embedded.transfers.split_transfers` (array)
    - Array containing the resource IDs of the  generated from the . 
- Only used for Split Transactions. For more information, see [Split Transactions](../../../../guides/online-payments/payment-features/split-transactions).

  - `_embedded.transfers.state` (string)
    The status of the .
    Enum: "CANCELED", "PENDING", "FAILED", "SUCCEEDED", "UNKNOWN", "RETURNED"

  - `_embedded.transfers.statement_descriptor` (string,null)
    The description of the  that appears on the buyer's bank or card statement.

  - `_embedded.transfers.subtype` (string)
    Additional information describing the .
    Enum: "API", "APPLICATION_FEE", "DISPUTE", "MERCHANT_CREDIT", "MERCHANT_CREDIT_ADJUSTMENT", "MERCHANT_DEBIT", "MERCHANT_DEBIT_ADJUSTMENT", "PLATFORM_CREDIT", "PLATFORM_CREDIT_ADJUSTMENT", "PLATFORM_DEBIT", "PLATFORM_DEBIT_ADJUSTMENT", "PLATFORM_FEE", "SETTLEMENT_MERCHANT", "SETTLEMENT_NOOP", "SETTLEMENT_PARTNER", "SETTLEMENT_PLATFORM", "SPLIT_PAYOUT", "SPLIT_PAYOUT_ADJUSTMENT", "SYSTEM"

  - `_embedded.transfers.supplemental_fee` (string,null)
    Amount in cents for which an additional fee will be created in addition to any fees created from the assigned fee profile.

  - `_embedded.transfers.tip_amount` (integer,null)
    The tip amount included in the total amount.

  - `_embedded.transfers.trace_id` (string,null)
    Trace ID of the . The processor sends back the  so you can track the  end-to-end.

  - `_embedded.transfers.type` (string)
    Type of .
    Enum: "DEBIT", "CREDIT", "REVERSAL", "FEE", "ADJUSTMENT", "DISPUTE", "RESERVE", "SETTLEMENT", "UNKNOWN"

  - `_embedded.transfers._links` (object)

  - `_embedded.transfers._links.application` (object)
    Link to the  the request was made under.

  - `_embedded.transfers._links.application.href` (string)

  - `_embedded.transfers._links.destination` (object)
    Link to the  where funds are getting sent.

  - `_embedded.transfers._links.device` (object)
    Link to the  the request was made under.

  - `_embedded.transfers._links.disputes` (object)
    Link to the  the request was made under.

  - `_embedded.transfers._links.fee_profile` (object)
    Link to the  the request was made under.

  - `_embedded.transfers._links.fees` (object)
    Link to the  the request is associated with.

  - `_embedded.transfers._links.merchant_identity` (object)
    Link to the  the  was created under and the  was submitted with.

  - `_embedded.transfers._links.payment_instruments` (object)
    Link to the  associated with the Transfer.

  - `_embedded.transfers._links.disputed_transfer` (object)
    Link to the  the  is about.

  - `_embedded.transfers._links.parent` (object)
    Link to the original resource that was used in the request.

  - `_embedded.transfers._links.reversals` (object)
    Link to the  associated with the .

  - `_embedded.transfers._links.self` (object)
    Link to the resource that was used in the request.

  - `_embedded.transfers._links.source` (object)
    Link to the  the  was created under.

## Response 401 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 403 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 404 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 406 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.