---
title: "Retrieve a Card Dispute"
method: GET
path: "/card_disputes/{card_dispute_id}"
---

# Retrieve a Card Dispute

`GET /card_disputes/{card_dispute_id}`

## Path parameters

- `card_dispute_id` string, required — The identifier of the Card Dispute.

## Response `200`

Card Dispute

- CardDispute — If unauthorized activity occurs on a card, you can create a Card Dispute and we'll work with the card networks to return the funds if appropriate.
  - `amount` integer, required — The amount of the dispute.
  - `card_id` string, required — The Card that the Card Dispute is associated with.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was created.
  - `disputed_transaction_id` string, required — The identifier of the Transaction that was disputed.
  - `id` string, required — The Card Dispute identifier.
  - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
  - `loss` object, nullable, required — If the Card Dispute's status is `lost`, this will contain details of the lost dispute.
    - `lost_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was lost.
    - `reason` 'user_withdrawn' | 'loss', required — The reason the Card Dispute was lost.
  - `network` 'visa' | 'pulse', required — The network that the Card Dispute is associated with.
  - `rejection` object, nullable, required — If the Card Dispute has been rejected, this will contain details of the rejection.
    - `explanation` string, required — Why the Card Dispute was rejected.
    - `rejected_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was rejected.
  - `status` 'user_submission_required' | 'pending_user_submission_reviewing' | 'pending_user_submission_submitting' | 'pending_user_withdrawal_submitting' | 'pending_response' | 'lost' | 'won' | 'rejected', required — The status of the Card Dispute.
  - `type` 'card_dispute', required — A constant representing the object's type. For this resource it will always be `card_dispute`.
  - `user_submission_required_by` string, date-time, nullable, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the user submission is required by. Present only if status is `user_submission_required` and a user submission is required by a certain time. Otherwise, this will be `nil`.
  - `visa` CardDisputeVisa, required
    - `network_events` CardDisputeVisaNetworkEvent[], required — The network events for the Card Dispute.
      - `attachment_files` CardDisputeFileAttachment[], required — The files attached to the Visa Card Dispute User Submission.
        - `file_id` string, required — The ID of the file attached to the Card Dispute.
      - `category` 'chargeback_accepted' | 'chargeback_submitted' | 'chargeback_timed_out' | 'merchant_prearbitration_decline_submitted' | 'merchant_prearbitration_received' | 'merchant_prearbitration_timed_out' | 'represented' | 'representment_timed_out' | 'user_prearbitration_accepted' | 'user_prearbitration_declined' | 'user_prearbitration_submitted' | 'user_prearbitration_timed_out' | 'user_withdrawal_submitted', required — The category of the user submission. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
      - `chargeback_accepted` object, nullable — A Card Dispute Chargeback Accepted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `chargeback_accepted`. Contains the details specific to a chargeback accepted Visa Card Dispute Network Event, which represents that a chargeback has been accepted by the merchant.
      - `chargeback_submitted` object, nullable — A Card Dispute Chargeback Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `chargeback_submitted`. Contains the details specific to a chargeback submitted Visa Card Dispute Network Event, which represents that a chargeback has been submitted to the network.
      - `chargeback_timed_out` object, nullable — A Card Dispute Chargeback Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `chargeback_timed_out`. Contains the details specific to a chargeback timed out Visa Card Dispute Network Event, which represents that the chargeback has timed out in the user's favor.
      - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Visa Card Dispute Network Event was created.
      - `dispute_financial_transaction_id` string, nullable, required — The dispute financial transaction that resulted from the network event, if any.
      - `merchant_prearbitration_decline_submitted` object, nullable — A Card Dispute Merchant Pre-Arbitration Decline Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_decline_submitted`. Contains the details specific to a merchant prearbitration decline submitted Visa Card Dispute Network Event, which represents that the user has declined the merchant's request for a prearbitration request decision in their favor.
      - `merchant_prearbitration_received` object, nullable — A Card Dispute Merchant Pre-Arbitration Received Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_received`. Contains the details specific to a merchant prearbitration received Visa Card Dispute Network Event, which represents that the merchant has issued a prearbitration request in the user's favor.
        - `cardholder_no_longer_disputes` object, nullable, required — Cardholder no longer disputes details. Present if and only if `reason` is `cardholder_no_longer_disputes`.
          - `explanation` string, nullable, required — Explanation for why the merchant believes the cardholder no longer disputes the transaction.
        - `compelling_evidence` object, nullable, required — Compelling evidence details. Present if and only if `reason` is `compelling_evidence`.
          - `category` 'authorized_signer' | 'delivery' | 'delivery_at_place_of_employment' | 'digital_goods_download' | 'dynamic_currency_conversion_actively_chosen' | 'flight_manifest_and_purchase_itinerary' | 'household_member_signer' | 'legitimate_spend_across_payment_types_for_same_merchandise' | 'merchandise_use' | 'passenger_transport_ticket_use' | 'recurring_transaction_with_binding_contract_or_previous_undisputed_transaction' | 'signed_delivery_or_pickup_form' | 'signed_mail_order_phone_order_form' | 'travel_and_expense_loyalty_transaction' | 'travel_and_expense_subsequent_purchase', required — The category of compelling evidence provided by the merchant.
          - `explanation` string, nullable, required — Explanation of the compelling evidence provided by the merchant.
        - `credit_or_reversal_processed` object, nullable, required — Credit or reversal processed details. Present if and only if `reason` is `credit_or_reversal_processed`.
          - `amount` integer, required — The amount of the credit or reversal in the minor unit of its currency. For dollars, for example, this is cents.
          - `currency` string, required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the credit or reversal's currency.
          - `explanation` string, nullable, required — Explanation for why the merchant believes the credit or reversal was processed.
          - `processed_at` string, date, required — The date the credit or reversal was processed.
        - `delayed_charge_transaction` object, nullable, required — Delayed charge transaction details. Present if and only if `reason` is `delayed_charge_transaction`.
          - `explanation` string, nullable, required — Additional details about the delayed charge transaction.
        - `evidence_of_imprint` object, nullable, required — Evidence of imprint details. Present if and only if `reason` is `evidence_of_imprint`.
          - `explanation` string, nullable, required — Explanation of the evidence of imprint.
        - `invalid_dispute` object, nullable, required — Invalid dispute details. Present if and only if `reason` is `invalid_dispute`.
          - `explanation` string, nullable, required — Explanation for why the dispute is considered invalid by the merchant.
          - `reason` 'other' | 'special_authorization_procedures_followed', required — The reason a merchant considers the dispute invalid.
        - `non_fiat_currency_or_non_fungible_token_received` object, nullable, required — Non-fiat currency or non-fungible token received details. Present if and only if `reason` is `non_fiat_currency_or_non_fungible_token_received`.
          - `blockchain_transaction_hash` string, required — Blockchain transaction hash.
          - `destination_wallet_address` string, required — Destination wallet address.
          - `prior_approved_transactions` string, nullable, required — Prior approved transactions.
        - `prior_undisputed_non_fraud_transactions` object, nullable, required — Prior undisputed non-fraud transactions details. Present if and only if `reason` is `prior_undisputed_non_fraud_transactions`.
          - `explanation` string, nullable, required — Explanation of the prior undisputed non-fraud transactions provided by the merchant.
        - `reason` 'cardholder_no_longer_disputes' | 'compelling_evidence' | 'credit_or_reversal_processed' | 'delayed_charge_transaction' | 'evidence_of_imprint' | 'invalid_dispute' | 'non_fiat_currency_or_non_fungible_token_received' | 'prior_undisputed_non_fraud_transactions', required — The reason the merchant re-presented the dispute.
      - `merchant_prearbitration_timed_out` object, nullable — A Card Dispute Merchant Pre-Arbitration Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_timed_out`. Contains the details specific to a merchant prearbitration timed out Visa Card Dispute Network Event, which represents that the user has timed out responding to the merchant's prearbitration request.
      - `represented` object, nullable — A Card Dispute Re-presented Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `represented`. Contains the details specific to a re-presented Visa Card Dispute Network Event, which represents that the merchant has declined the user's chargeback and has re-presented the payment.
        - `cardholder_no_longer_disputes` object, nullable, required — Cardholder no longer disputes details. Present if and only if `reason` is `cardholder_no_longer_disputes`.
          - `explanation` string, nullable, required — Explanation for why the merchant believes the cardholder no longer disputes the transaction.
        - `credit_or_reversal_processed` object, nullable, required — Credit or reversal processed details. Present if and only if `reason` is `credit_or_reversal_processed`.
          - `amount` integer, required — The amount of the credit or reversal in the minor unit of its currency. For dollars, for example, this is cents.
          - `currency` string, required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the credit or reversal's currency.
          - `explanation` string, nullable, required — Explanation for why the merchant believes the credit or reversal was processed.
          - `processed_at` string, date, required — The date the credit or reversal was processed.
        - `invalid_dispute` object, nullable, required — Invalid dispute details. Present if and only if `reason` is `invalid_dispute`.
          - `explanation` string, nullable, required — Explanation for why the dispute is considered invalid by the merchant.
          - `reason` 'automatic_teller_machine_transaction_proof_provided' | 'balance_of_partial_prepayment_not_paid' | 'cardholder_canceled_before_expected_merchandise_receipt_date' | 'cardholder_canceled_before_expected_services_receipt_date' | 'cardholder_canceled_different_date' | 'cardholder_did_not_cancel_according_to_policy' | 'cardholder_received_merchandise' | 'country_code_correct' | 'credit_processed_correctly' | 'currency_correct' | 'dispute_is_for_quality' | 'dispute_is_for_visa_cash_back_transaction_portion' | 'disputed_amount_is_value_added_tax' | 'disputed_amount_is_value_added_tax_no_credit_receipt_provided' | 'limited_return_or_cancellation_policy_properly_disclosed' | 'merchandise_held_at_cardholder_customs_agency' | 'merchandise_matches_description' | 'merchandise_not_counterfeit' | 'merchandise_not_damaged' | 'merchandise_not_defective' | 'merchandise_provided_prior_to_cancellation_date' | 'merchandise_quality_matches_description' | 'merchandise_return_not_attempted' | 'merchant_not_notified_of_closed_account' | 'name_on_flight_manifest_matches_purchase' | 'no_credit_receipt_provided' | 'other' | 'processing_error_incorrect' | 'returned_mechandise_held_at_customs_agency_outside_merchant_country' | 'services_match_description' | 'services_provided_prior_to_cancellation_date' | 'services_used_after_cancellation_date' | 'terms_of_service_not_misrepresented' | 'transaction_code_correct', required — The reason a merchant considers the dispute invalid.
        - `non_fiat_currency_or_non_fungible_token_as_described` object, nullable, required — Non-fiat currency or non-fungible token as described details. Present if and only if `reason` is `non_fiat_currency_or_non_fungible_token_as_described`.
        - `non_fiat_currency_or_non_fungible_token_received` object, nullable, required — Non-fiat currency or non-fungible token received details. Present if and only if `reason` is `non_fiat_currency_or_non_fungible_token_received`.
          - `blockchain_transaction_hash` string, required — Blockchain transaction hash.
          - `destination_wallet_address` string, required — Destination wallet address.
          - `prior_approved_transactions` string, nullable, required — Prior approved transactions.
        - `proof_of_cash_disbursement` object, nullable, required — Proof of cash disbursement details. Present if and only if `reason` is `proof_of_cash_disbursement`.
          - `explanation` string, nullable, required — Explanation for why the merchant believes the evidence provides proof of cash disbursement.
        - `reason` 'cardholder_no_longer_disputes' | 'credit_or_reversal_processed' | 'invalid_dispute' | 'non_fiat_currency_or_non_fungible_token_as_described' | 'non_fiat_currency_or_non_fungible_token_received' | 'proof_of_cash_disbursement' | 'reversal_issued', required — The reason the merchant re-presented the dispute.
        - `reversal_issued` object, nullable, required — Reversal issued by merchant details. Present if and only if `reason` is `reversal_issued`.
          - `explanation` string, nullable, required — Explanation of the reversal issued by the merchant.
      - `representment_timed_out` object, nullable — A Card Dispute Re-presentment Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `representment_timed_out`. Contains the details specific to a re-presentment time-out Visa Card Dispute Network Event, which represents that the user did not respond to the re-presentment by the merchant within the time limit.
      - `user_prearbitration_accepted` object, nullable — A Card Dispute User Pre-Arbitration Accepted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_accepted`. Contains the details specific to a user prearbitration accepted Visa Card Dispute Network Event, which represents that the merchant has accepted the user's prearbitration request in the user's favor.
      - `user_prearbitration_declined` object, nullable — A Card Dispute User Pre-Arbitration Declined Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_declined`. Contains the details specific to a user prearbitration declined Visa Card Dispute Network Event, which represents that the merchant has declined the user's prearbitration request.
      - `user_prearbitration_submitted` object, nullable — A Card Dispute User Pre-Arbitration Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_submitted`. Contains the details specific to a user prearbitration submitted Visa Card Dispute Network Event, which represents that the user's request for prearbitration has been submitted to the network.
      - `user_prearbitration_timed_out` object, nullable — A Card Dispute User Pre-Arbitration Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_timed_out`. Contains the details specific to a user prearbitration timed out Visa Card Dispute Network Event, which represents that the merchant has timed out responding to the user's prearbitration request.
      - `user_withdrawal_submitted` object, nullable — A Card Dispute User Withdrawal Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_withdrawal_submitted`. Contains the details specific to a user withdrawal submitted Visa Card Dispute Network Event, which represents that the user's request to withdraw the dispute has been submitted to the network.
    - `required_user_submission_category` 'chargeback' | 'merchant_prearbitration_decline' | 'user_prearbitration', nullable, required — The category of the currently required user submission if the user wishes to proceed with the dispute. Present if and only if status is `user_submission_required`. Otherwise, this will be `nil`.
    - `user_submissions` CardDisputeVisaUserSubmission[], required — The user submissions for the Card Dispute.
      - `accepted_at` string, date-time, nullable, required — The date and time at which the Visa Card Dispute User Submission was reviewed and accepted.
      - `amount` integer, nullable, required — The amount of the dispute if it is different from the amount of a prior user submission or the disputed transaction.
      - `attachment_files` CardDisputeFileAttachment[], required — The files attached to the Visa Card Dispute User Submission.
        - `file_id` string, required — The ID of the file attached to the Card Dispute.
      - `category` 'chargeback' | 'merchant_prearbitration_decline' | 'user_prearbitration', required — The category of the user submission. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
      - `chargeback` object, nullable — A Visa Card Dispute Chargeback User Submission Chargeback Details object. This field will be present in the JSON response if and only if `category` is equal to `chargeback`. Contains the details specific to a Visa chargeback User Submission for a Card Dispute.
        - `authorization` object, nullable, required — Authorization. Present if and only if `category` is `authorization`.
          - `account_status` 'account_closed' | 'credit_problem' | 'fraud', required — Account status.
        - `category` 'authorization' | 'consumer_canceled_merchandise' | 'consumer_canceled_recurring_transaction' | 'consumer_canceled_services' | 'consumer_counterfeit_merchandise' | 'consumer_credit_not_processed' | 'consumer_damaged_or_defective_merchandise' | 'consumer_merchandise_misrepresentation' | 'consumer_merchandise_not_as_described' | 'consumer_merchandise_not_received' | 'consumer_non_receipt_of_cash' | 'consumer_original_credit_transaction_not_accepted' | 'consumer_quality_merchandise' | 'consumer_quality_services' | 'consumer_services_misrepresentation' | 'consumer_services_not_as_described' | 'consumer_services_not_received' | 'fraud' | 'processing_error', required — Category.
        - `consumer_canceled_merchandise` object, nullable, required — Canceled merchandise. Present if and only if `category` is `consumer_canceled_merchandise`.
          - `cardholder_cancellation` object, nullable, required — Cardholder cancellation.
            - `canceled_at` string, date, required — Canceled at.
            - `canceled_prior_to_ship_date` 'canceled_prior_to_ship_date' | 'not_canceled_prior_to_ship_date', required — Canceled prior to ship date.
            - `cancellation_policy_provided` 'not_provided' | 'provided', required — Cancellation policy provided.
            - `reason` string, required — Reason.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`.
          - `purchase_explanation` string, required — Purchase explanation.
          - `received_or_expected_at` string, date, required — Received or expected at.
          - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`.
            - `attempt_explanation` string, required — Attempt explanation.
            - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason.
            - `attempted_at` string, date, required — Attempted at.
            - `merchandise_disposition` string, required — Merchandise disposition.
          - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome.
          - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`.
            - `merchant_received_return_at` string, date, nullable, required — Merchant received return at.
            - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`.
            - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method.
            - `returned_at` string, date, required — Returned at.
            - `tracking_number` string, nullable, required — Tracking number.
        - `consumer_canceled_recurring_transaction` object, nullable, required — Canceled recurring transaction. Present if and only if `category` is `consumer_canceled_recurring_transaction`.
          - `cancellation_target` 'account' | 'transaction', required — Cancellation target.
          - `merchant_contact_methods` object, required — Merchant contact methods.
            - `application_name` string, nullable, required — Application name.
            - `call_center_phone_number` string, nullable, required — Call center phone number.
            - `email_address` string, nullable, required — Email address.
            - `in_person_address` string, nullable, required — In person address.
            - `mailing_address` string, nullable, required — Mailing address.
            - `text_phone_number` string, nullable, required — Text phone number.
          - `other_form_of_payment_explanation` string, nullable, required — Other form of payment explanation.
          - `transaction_or_account_canceled_at` string, date, required — Transaction or account canceled at.
        - `consumer_canceled_services` object, nullable, required — Canceled services. Present if and only if `category` is `consumer_canceled_services`.
          - `cardholder_cancellation` object, required — Cardholder cancellation.
            - `canceled_at` string, date, required — Canceled at.
            - `cancellation_policy_provided` 'not_provided' | 'provided', required — Cancellation policy provided.
            - `reason` string, required — Reason.
          - `contracted_at` string, date, required — Contracted at.
          - `guaranteed_reservation` object, nullable, required — Guaranteed reservation explanation. Present if and only if `service_type` is `guaranteed_reservation`.
            - `explanation` 'cardholder_canceled_prior_to_service' | 'cardholder_cancellation_attempt_within_24_hours_of_confirmation' | 'merchant_billed_no_show', required — Explanation.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `other` object, nullable, required — Other service type explanation. Present if and only if `service_type` is `other`.
          - `purchase_explanation` string, required — Purchase explanation.
          - `service_type` 'guaranteed_reservation' | 'other' | 'timeshare', required — Service type.
          - `timeshare` object, nullable, required — Timeshare explanation. Present if and only if `service_type` is `timeshare`.
        - `consumer_counterfeit_merchandise` object, nullable, required — Counterfeit merchandise. Present if and only if `category` is `consumer_counterfeit_merchandise`.
          - `counterfeit_explanation` string, required — Counterfeit explanation.
          - `disposition_explanation` string, required — Disposition explanation.
          - `order_explanation` string, required — Order explanation.
          - `received_at` string, date, required — Received at.
        - `consumer_credit_not_processed` object, nullable, required — Credit not processed. Present if and only if `category` is `consumer_credit_not_processed`.
          - `canceled_or_returned_at` string, date, nullable, required — Canceled or returned at.
          - `credit_expected_at` string, date, nullable, required — Credit expected at.
        - `consumer_damaged_or_defective_merchandise` object, nullable, required — Damaged or defective merchandise. Present if and only if `category` is `consumer_damaged_or_defective_merchandise`.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`.
          - `order_and_issue_explanation` string, required — Order and issue explanation.
          - `received_at` string, date, required — Received at.
          - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`.
            - `attempt_explanation` string, required — Attempt explanation.
            - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason.
            - `attempted_at` string, date, required — Attempted at.
            - `merchandise_disposition` string, required — Merchandise disposition.
          - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome.
          - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`.
            - `merchant_received_return_at` string, date, nullable, required — Merchant received return at.
            - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`.
            - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method.
            - `returned_at` string, date, required — Returned at.
            - `tracking_number` string, nullable, required — Tracking number.
        - `consumer_merchandise_misrepresentation` object, nullable, required — Merchandise misrepresentation. Present if and only if `category` is `consumer_merchandise_misrepresentation`.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `misrepresentation_explanation` string, required — Misrepresentation explanation.
          - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`.
          - `purchase_explanation` string, required — Purchase explanation.
          - `received_at` string, date, required — Received at.
          - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`.
            - `attempt_explanation` string, required — Attempt explanation.
            - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason.
            - `attempted_at` string, date, required — Attempted at.
            - `merchandise_disposition` string, required — Merchandise disposition.
          - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome.
          - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`.
            - `merchant_received_return_at` string, date, nullable, required — Merchant received return at.
            - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`.
            - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method.
            - `returned_at` string, date, required — Returned at.
            - `tracking_number` string, nullable, required — Tracking number.
        - `consumer_merchandise_not_as_described` object, nullable, required — Merchandise not as described. Present if and only if `category` is `consumer_merchandise_not_as_described`.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `received_at` string, date, required — Received at.
          - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`.
            - `attempt_explanation` string, required — Attempt explanation.
            - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason.
            - `attempted_at` string, date, required — Attempted at.
            - `merchandise_disposition` string, required — Merchandise disposition.
          - `return_outcome` 'returned' | 'return_attempted', required — Return outcome.
          - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`.
            - `merchant_received_return_at` string, date, nullable, required — Merchant received return at.
            - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`.
            - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method.
            - `returned_at` string, date, required — Returned at.
            - `tracking_number` string, nullable, required — Tracking number.
        - `consumer_merchandise_not_received` object, nullable, required — Merchandise not received. Present if and only if `category` is `consumer_merchandise_not_received`.
          - `cancellation_outcome` 'cardholder_cancellation_prior_to_expected_receipt' | 'merchant_cancellation' | 'no_cancellation', required — Cancellation outcome.
          - `cardholder_cancellation_prior_to_expected_receipt` object, nullable, required — Cardholder cancellation prior to expected receipt. Present if and only if `cancellation_outcome` is `cardholder_cancellation_prior_to_expected_receipt`.
            - `canceled_at` string, date, required — Canceled at.
            - `reason` string, nullable, required — Reason.
          - `delayed` object, nullable, required — Delayed. Present if and only if `delivery_issue` is `delayed`.
            - `explanation` string, required — Explanation.
            - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`.
            - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`.
              - …
            - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome.
            - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`.
              - …
          - `delivered_to_wrong_location` object, nullable, required — Delivered to wrong location. Present if and only if `delivery_issue` is `delivered_to_wrong_location`.
            - `agreed_location` string, required — Agreed location.
          - `delivery_issue` 'delayed' | 'delivered_to_wrong_location', required — Delivery issue.
          - `last_expected_receipt_at` string, date, required — Last expected receipt at.
          - `merchant_cancellation` object, nullable, required — Merchant cancellation. Present if and only if `cancellation_outcome` is `merchant_cancellation`.
            - `canceled_at` string, date, required — Canceled at.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `no_cancellation` object, nullable, required — No cancellation. Present if and only if `cancellation_outcome` is `no_cancellation`.
          - `purchase_info_and_explanation` string, required — Purchase information and explanation.
        - `consumer_non_receipt_of_cash` object, nullable, required — Non-receipt of cash. Present if and only if `category` is `consumer_non_receipt_of_cash`.
        - `consumer_original_credit_transaction_not_accepted` object, nullable, required — Original Credit Transaction (OCT) not accepted. Present if and only if `category` is `consumer_original_credit_transaction_not_accepted`.
          - `explanation` string, required — Explanation.
          - `reason` 'prohibited_by_local_laws_or_regulation' | 'recipient_refused', required — Reason.
        - `consumer_quality_merchandise` object, nullable, required — Merchandise quality issue. Present if and only if `category` is `consumer_quality_merchandise`.
          - `expected_at` string, date, required — Expected at.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`.
          - `ongoing_negotiations` object, nullable, required — Ongoing negotiations. Exclude if there is no evidence of ongoing negotiations.
            - `explanation` string, required — Explanation of the previous ongoing negotiations between the cardholder and merchant.
            - `issuer_first_notified_at` string, date, required — Date the cardholder first notified the issuer of the dispute.
            - `started_at` string, date, required — Started at.
          - `purchase_info_and_quality_issue` string, required — Purchase information and quality issue.
          - `received_at` string, date, required — Received at.
          - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`.
            - `attempt_explanation` string, required — Attempt explanation.
            - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason.
            - `attempted_at` string, date, required — Attempted at.
            - `merchandise_disposition` string, required — Merchandise disposition.
          - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome.
          - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`.
            - `merchant_received_return_at` string, date, nullable, required — Merchant received return at.
            - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`.
            - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method.
            - `returned_at` string, date, required — Returned at.
            - `tracking_number` string, nullable, required — Tracking number.
        - `consumer_quality_services` object, nullable, required — Services quality issue. Present if and only if `category` is `consumer_quality_services`.
          - `cardholder_cancellation` object, required — Cardholder cancellation.
            - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant.
            - `canceled_at` string, date, required — Canceled at.
            - `reason` string, required — Reason.
          - `cardholder_paid_to_have_work_redone` 'did_not_pay_to_have_work_redone' | 'paid_to_have_work_redone', nullable, required — Cardholder paid to have work redone.
          - `non_fiat_currency_or_non_fungible_token_related_and_not_matching_description` 'not_related' | 'related', required — Non-fiat currency or non-fungible token related and not matching description.
          - `ongoing_negotiations` object, nullable, required — Ongoing negotiations. Exclude if there is no evidence of ongoing negotiations.
            - `explanation` string, required — Explanation of the previous ongoing negotiations between the cardholder and merchant.
            - `issuer_first_notified_at` string, date, required — Date the cardholder first notified the issuer of the dispute.
            - `started_at` string, date, required — Started at.
          - `purchase_info_and_quality_issue` string, required — Purchase information and quality issue.
          - `restaurant_food_related` 'not_related' | 'related', nullable, required — Whether the dispute is related to the quality of food from an eating place or restaurant. Must be provided when Merchant Category Code (MCC) is 5812, 5813 or 5814.
          - `services_received_at` string, date, required — Services received at.
        - `consumer_services_misrepresentation` object, nullable, required — Services misrepresentation. Present if and only if `category` is `consumer_services_misrepresentation`.
          - `cardholder_cancellation` object, required — Cardholder cancellation.
            - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant.
            - `canceled_at` string, date, required — Canceled at.
            - `reason` string, required — Reason.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `misrepresentation_explanation` string, required — Misrepresentation explanation.
          - `purchase_explanation` string, required — Purchase explanation.
          - `received_at` string, date, required — Received at.
        - `consumer_services_not_as_described` object, nullable, required — Services not as described. Present if and only if `category` is `consumer_services_not_as_described`.
          - `cardholder_cancellation` object, required — Cardholder cancellation.
            - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant.
            - `canceled_at` string, date, required — Canceled at.
            - `reason` string, required — Reason.
          - `explanation` string, required — Explanation of what was ordered and was not as described.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `received_at` string, date, required — Received at.
        - `consumer_services_not_received` object, nullable, required — Services not received. Present if and only if `category` is `consumer_services_not_received`.
          - `cancellation_outcome` 'cardholder_cancellation_prior_to_expected_receipt' | 'merchant_cancellation' | 'no_cancellation', required — Cancellation outcome.
          - `cardholder_cancellation_prior_to_expected_receipt` object, nullable, required — Cardholder cancellation prior to expected receipt. Present if and only if `cancellation_outcome` is `cardholder_cancellation_prior_to_expected_receipt`.
            - `canceled_at` string, date, required — Canceled at.
            - `reason` string, nullable, required — Reason.
          - `last_expected_receipt_at` string, date, required — Last expected receipt at.
          - `merchant_cancellation` object, nullable, required — Merchant cancellation. Present if and only if `cancellation_outcome` is `merchant_cancellation`.
            - `canceled_at` string, date, required — Canceled at.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `no_cancellation` object, nullable, required — No cancellation. Present if and only if `cancellation_outcome` is `no_cancellation`.
          - `purchase_info_and_explanation` string, required — Purchase information and explanation.
        - `fraud` object, nullable, required — Fraud. Present if and only if `category` is `fraud`.
          - `fraud_type` 'account_or_credentials_takeover' | 'card_not_received_as_issued' | 'fraudulent_application' | 'fraudulent_use_of_account_number' | 'incorrect_processing' | 'issuer_reported_counterfeit' | 'lost' | 'manipulation_of_account_holder' | 'merchant_misrepresentation' | 'miscellaneous' | 'stolen', required — Fraud type.
        - `processing_error` object, nullable, required — Processing error. Present if and only if `category` is `processing_error`.
          - `duplicate_transaction` object, nullable, required — Duplicate transaction. Present if and only if `error_reason` is `duplicate_transaction`.
            - `other_transaction_id` string, required — Other transaction ID.
          - `error_reason` 'duplicate_transaction' | 'incorrect_amount' | 'paid_by_other_means', required — Error reason.
          - `incorrect_amount` object, nullable, required — Incorrect amount. Present if and only if `error_reason` is `incorrect_amount`.
            - `expected_amount` integer, required — Expected amount.
          - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted.
          - `paid_by_other_means` object, nullable, required — Paid by other means. Present if and only if `error_reason` is `paid_by_other_means`.
            - `other_form_of_payment_evidence` 'canceled_check' | 'card_transaction' | 'cash_receipt' | 'other' | 'statement' | 'voucher', required — Other form of payment evidence.
            - `other_transaction_id` string, nullable, required — Other transaction ID.
      - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Visa Card Dispute User Submission was created.
      - `explanation` string, nullable, required — The free-form explanation provided to Increase to provide more context for the user submission. This field is not sent directly to the card networks.
      - `further_information_requested_at` string, date-time, nullable, required — The date and time at which Increase requested further information from the user for the Visa Card Dispute.
      - `further_information_requested_reason` string, nullable, required — The reason for Increase requesting further information from the user for the Visa Card Dispute.
      - `merchant_prearbitration_decline` object, nullable — A Visa Card Dispute Merchant Pre-Arbitration Decline User Submission object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_decline`. Contains the details specific to a merchant prearbitration decline Visa Card Dispute User Submission.
        - `reason` string, required — The reason the user declined the merchant's request for pre-arbitration in their favor.
      - `status` 'abandoned' | 'accepted' | 'further_information_requested' | 'pending_reviewing', required — The status of the Visa Card Dispute User Submission.
      - `updated_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Visa Card Dispute User Submission was updated.
      - `user_prearbitration` object, nullable — A Visa Card Dispute User-Initiated Pre-Arbitration User Submission object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration`. Contains the details specific to a user-initiated pre-arbitration Visa Card Dispute User Submission.
        - `category_change` object, nullable, required — Category change details for the pre-arbitration request, if requested.
          - `category` 'authorization' | 'consumer_canceled_merchandise' | 'consumer_canceled_recurring_transaction' | 'consumer_canceled_services' | 'consumer_counterfeit_merchandise' | 'consumer_credit_not_processed' | 'consumer_damaged_or_defective_merchandise' | 'consumer_merchandise_misrepresentation' | 'consumer_merchandise_not_as_described' | 'consumer_merchandise_not_received' | 'consumer_non_receipt_of_cash' | 'consumer_original_credit_transaction_not_accepted' | 'consumer_quality_merchandise' | 'consumer_quality_services' | 'consumer_services_misrepresentation' | 'consumer_services_not_as_described' | 'consumer_services_not_received' | 'fraud' | 'processing_error', required — The category the dispute is being changed to.
          - `reason` string, required — The reason for the pre-arbitration request.
        - `reason` string, required — The reason for the pre-arbitration request.
  - `win` object, nullable, required — If the Card Dispute's status is `won`, this will contain details of the won dispute.
    - `won_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was won.
  - `withdrawal` object, nullable, required — If the Card Dispute has been withdrawn, this will contain details of the withdrawal.
    - `explanation` string, nullable, required — The explanation for the withdrawal of the Card Dispute.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)