# List Dispute Adjustment Transfers

List the adjustment Transfers for a Dispute. Depending on the stage of the Dispute, different adjustment Transfer subtypes can be applied.

There are four available subtypes for adjustment Transfers in Disputes:

- PLATFORM_CREDIT
- MERCHANT_DEBIT
- MERCHANT_CREDIT
- PLATFORM_DEBIT

Endpoint: `GET /disputes/{dispute_id}/adjustment_transfers`
Security: `BasicAuth`

## Path parameters:

- `dispute_id` (string, required)
    ID of the Dispute resource.
    Example: "DIgDv9764vkkEVu1suZNCDbR"

## Header parameters:

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

## Query parameters:

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

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

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

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

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

- `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"

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

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

## 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.transferes` (array)

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

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

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

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

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

- `_embedded.transferes.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.transferes.additional_buyer_charges.surcharge_amount` (integer,null)
    A surcharge amount to charge the buyer for the transaction. This object property is mutually exclusive.

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

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

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

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

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

- `_embedded.transferes.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). Please note that Visa is ending its Level 2 offering in April 2026.

- `_embedded.transferes.additional_purchase_data.customer_reference_number` (string)
    The customer reference for the purchase (max 17 characters). For Visa, this field no longer qualifies for lower interchange after April 17, 2026. Include item_data for Level 3 processing.

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

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

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

- `_embedded.transferes.additional_purchase_data.discount_amount` (integer)
    The amount in cents of the discount for the order. You must include this field to qualify for Level 3 interchange benefits. Even if the value is (0), you should pass the field to qualify for Level 3.

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

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

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

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

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

- `_embedded.transferes.additional_purchase_data.sales_tax` (integer)
    Total aggregate tax amount in cents for the entire purchase. Field is automatically calculated if you pass in the itemized tax amounts.

- `_embedded.transferes.additional_purchase_data.sales_tax_finix_generated` (integer,null)
    The sales tax amount in cents Finix calculated from the item_data line items.

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

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

- `_embedded.transferes.additional_purchase_data.tax_exempt` (boolean)
    For tax exempt purchases set to True.

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

- `_embedded.transferes.additional_purchase_data.item_data.amount_excluding_sales_tax` (integer)
    Total cost of the line item in cents, excluding tax.

- `_embedded.transferes.additional_purchase_data.item_data.amount_including_sales_tax` (integer)
    Total cost of the line item in cents, including tax.

- `_embedded.transferes.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.

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

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

- `_embedded.transferes.additional_purchase_data.item_data.item_discount_amount` (integer)
    The item discount amount in cents.

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

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

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

- `_embedded.transferes.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.transferes.amount` (integer)
    The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).
    Example: 5000

- `_embedded.transferes.amount_requested` (integer)
    The amount that was requested to get debited from the source when the transaction was created, in cents (e.g., 100 = $1.00).
    Example: 100

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

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

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

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

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

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

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

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

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

- `_embedded.transferes.card_present_details.emv_data.application_identifier` (string)
    ID of the application used in the transaction.

- `_embedded.transferes.card_present_details.emv_data.application_label` (string)
    EMV application label.

- `_embedded.transferes.card_present_details.emv_data.application_preferred_name` (string,null)
    EMV application label with formatting (if provided).

- `_embedded.transferes.card_present_details.emv_data.application_transaction_counter` (string)
    Transaction number for the EMV application.

- `_embedded.transferes.card_present_details.emv_data.cryptogram` (string)
    Cryptogram returned by the card.

- `_embedded.transferes.card_present_details.emv_data.issuer_code_table_index` (string,null)
    The alphabet code table used by the EMV application (if provided).

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

- `_embedded.transferes.card_present_details.emv_data.tags` (object,null)
    Include up to 50 key: value pairs to annotate requests with custom metadata.

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

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

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

- `_embedded.transferes.card_present_details.payment_type` (string)
    The type of Payment Instrument used in the transaction.

- `_embedded.transferes.currency` (string)
    ISO 4217 3-letter currency code.
    Enum: "CAD", "USD"

- `_embedded.transferes.created_via` (string)
    Gives more information about the product flow that was used to create the resource.

- `_embedded.transferes.destination` (string,null)
    ID of the Payment Instrument where funds will be sent.

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

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

- `_embedded.transferes.failure_code` (string,null)
    The code of the failure so the decline can be handled programmatically.

- `_embedded.transferes.failure_message` (string,null)
    A human-readable description of why the transaction was declined.

- `_embedded.transferes.fee` (integer)
    The minimum amount of the Transfer you'd like to collect as your fee in cents. Defaults to zero.

- `_embedded.transferes.fee_profile` (string)
    The ID of the Fee Profile that will be used for calculating fees for this transfer.

- `_embedded.transferes.funds_flow_type` (string,null)
    The type of disbursement to perform. Defaults to GENERAL_PAYOUT.

- `_embedded.transferes.idempotency_id` (string,null)
    Pass any randomly generated or internal ID to identify Transfers, Authorizations, or refund requests.

- `_embedded.transferes.ip_address_details` (object,null)
    Always returns null.

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

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

- `_embedded.transferes.network_details` (object)
    Contains network-specific fields used by issuers to identify transactions.

- `_embedded.transferes.network_details.brand` (string)
    Card brand associated with the saved payment instrument.
    Example: "VISA"

- `_embedded.transferes.network_details.authorization_code` (string)
    Code returned by the issuing bank when a transaction is authorized.
    Example: 840735

- `_embedded.transferes.network_details.acquirer_reference_number` (string,null)
    Unique identifier banks use to trace chargebacks or refunds. Available only for Mastercard transactions; otherwise returns null.
    Example: 521600805857

- `_embedded.transferes.operation_key` (string,null)
    Details the operation that's performed in the transaction.

- `_embedded.transferes.parent_transfer` (string,null)
    ID of the original parent Transfer. Only present when type is REVERSAL.

- `_embedded.transferes.parent_transfer_trace_id` (string,null)
    The trace_id of the original parent Transfer. Only present when type is REVERSAL.

- `_embedded.transferes.pull_transfer_id` (string,null)
    The ID of the corresponding pull Transfer linked in a ME_TO_ME transaction.

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

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

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

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

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

- `_embedded.transferes.split_transfers` (array)
    Array containing the resource IDs of the Split Transfers generated from the Transfer.

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

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

- `_embedded.transferes.subtype` (string)
    Additional information describing the payment_type.

- `_embedded.transferes.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.transferes.tags` (object,null)
    Include up to 50 key: value pairs to annotate requests with custom metadata.

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

- `_embedded.transferes.trace_id` (string,null)
    Trace ID of the Transfer.

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

- `_embedded.transferes.third_party_details` (object,null)
    Details about the third-party processor associated with the Transfer.

- `_embedded.transferes.third_party_details.external_trace_id` (string,null)
    The trace ID returned by the third-party processor used to identify the Transfer.

- `_embedded.transferes.third_party_details.type` (string,null)
    The name of the third-party processor associated with the Transfer.
    Enum: "CYBERSOURCE"

- `_embedded.transferes._links` (object)

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

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

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

- `_embedded.transferes._links.destination.href` (string)

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

- `_embedded.transferes._links.device.href` (string)

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

- `_embedded.transferes._links.disputes.href` (string)

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

- `_embedded.transferes._links.fee_profile.href` (string)

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

- `_embedded.transferes._links.fees.href` (string)

- `_embedded.transferes._links.merchant_identity` (object)
    Link to the Identity the Merchant was created under and the Transfer was submitted with.

- `_embedded.transferes._links.merchant_identity.href` (string)

- `_embedded.transferes._links.payment_instruments` (object)
    Link to the Payment Instrument associated with the Transfer.

- `_embedded.transferes._links.payment_instruments.href` (string)

- `_embedded.transferes._links.disputed_transfer` (object)
    Link to the Transfer the Dispute is about.

- `_embedded.transferes._links.disputed_transfer.href` (string)

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

- `_embedded.transferes._links.parent.href` (string)

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

- `_embedded.transferes._links.reversals.href` (string)

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

- `_embedded.transferes._links.self.href` (string)

- `_embedded.transferes._links.source` (object)
    Link to the Payment Instrument the Transfer was created under.

- `_embedded.transferes._links.source.href` (string)

- `_links` (object)

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

- `_links.self.href` (string)

- `_links.next` (object)
    Link to the next page of entries.

- `_links.next.href` (string)

## 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 UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)
    A log reference identifier for the error, useful for debugging and support purposes.

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

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

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

- `_embedded.errors._links.self.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 UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)
    A log reference identifier for the error, useful for debugging and support purposes.

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

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

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

- `_embedded.errors._links.self.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 UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)
    A log reference identifier for the error, useful for debugging and support purposes.

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

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

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

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

## Response 422 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 UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)
    A log reference identifier for the error, useful for debugging and support purposes.

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

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

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

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