> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List dispute cases

> List existing dispute cases.

<div className="mb-4 flex items-center gap-2"><span className="rounded-lg font-bold px-1.5 py-0.5 text-sm leading-5 bg-green-400/20 text-green-700 dark:text-green-400">GET</span><span className="flex items-center gap-0.5 font-mono text-sm"><span className="text-gray-400">/</span><span className="font-medium text-gray-800 dark:text-white">{"cases"}</span></span></div>

List existing dispute cases. This endpoint supports [sorting and pagination](/docs/core-api/sorting-and-pagination/).

<h2 id="_query_parameters">
  Query parameters
</h2>

| Fields | Description |
| - | - |
| 3ds<br />boolean<br />Optional | Returns dispute cases that involve 3DS.<br />**Allowable Values:**<br />`true`, `false` |
| assignee<br />string<br />Optional | Returns dispute cases associated with the specified assignee.<br />**Allowable Values:**<br />255 char max |
| associated\_transaction\_required<br />boolean<br />Optional | Returns dispute cases that have any associated transactions.<br />**Allowable Values:**<br />`true`, `false` |
| chargeback\_token<br />string<br />Optional | Returns dispute cases associated with the specified chargeback.<br />**Allowable Values:**<br />36 char max |
| dispute\_state<br />array of strings<br />Optional | Returns a comma-separated list of dispute states that will be used to filter the resulting case.<br />**Allowable Values:**<br />`INITIATED`, `REPRESENTMENT`, `PRE_ARBITRATION`, `ARBITRATION`, `CASE_WON`, `CASE_LOST`, `NETWORK_REJECTED`, `CLOSED`, `WRITTEN_OFF_ISSUER`, `WRITTEN_OFF_PROGRAM` |
| network\_case\_number<br />string<br />Optional | Returns dispute cases associated with the specified network case number.<br />**Allowable Values:**<br />A valid network case number. |
| next\_actor<br />string<br />Optional | Returns the dispute cases associated with the specified next actor, such as `ISSUER`, `ACQUIRER`, `COURT`, or `DISPUTE_COMPLETED`.<br />**Allowable Values:**<br />An existing next actor. |
| original\_transaction\_token<br />string<br />Optional | Returns dispute cases associated with the specified token.<br />**Allowable Values:**<br />36 char max |
| reason<br />string<br />Optional | Returns disputes that are using the provided dispute reason.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/create-case#_the_dispute_details_dispute_reason_field">Dispute case reasons</a>. |
| state<br />string<br />Optional | Returns a comma-separated list of case states that will be used to filter the resulting case.<br />**Allowable Values:**<br />`OPEN`, `OPEN_WITH_ACTION_REQUIRED`, `READY`, `CHARGEBACK_INITIATED`, `CLOSED` |
| type<br />string<br />Optional | Returns cases of the specified type.<br />**Allowable Values:**<br />`DISPUTE` |
| user\_token<br />string<br />Optional | Returns dispute cases associated with the specified user.<br />**Allowable Values:**<br />36 char max |

<h2 id="_response_body_3">
  Response body
</h2>

| Fields | Description |
| - | - |
| token<br />string<br />Returned | The unique identifier of the dispute case.<br />**Allowable Values:**<br />36 char max |
| type<br />string<br />Returned | The type of case.<br />**Allowable Values:**<br />`DISPUTE` |
| memo<br />string<br />Returned | Free-form comments about the dispute.<br />**Allowable Values:**<br />512 char max |
| program\_short\_code<br />string<br />Returned | Indicates what program the case belongs to.<br />**Allowable Values:**<br />10 char max |
| user\_token<br />string<br />Returned | Token that identifies the user that made the original transaction.<br />**Allowable Values:**<br />36 char max |
| business\_token<br />string<br />Returned | The token of the business involved in the dispute case.<br />**Allowable Values:**<br />36 char max |
| state<br />string<br />Returned | Indicates the current case state.<br />**Allowable Values:**<br />`OPEN`, `OPEN_WITH_ACTION_REQUIRED`, `READY`, `CHARGEBACK_INITIATED`, `CLOSED` |
| assignee<br />string<br />Returned | Indicates who is working on the case. This is updated by the case transition endpoint with reason code 22 and `ASSIGN` action.<br />**Allowable Values:**<br />255 char max |
| zendesk\_ticket\_id<br />string<br />Optional | ID for the Zendesk ticket.<br />**Allowable Values:**<br />255 char max |
| type\_change\_time<br />datetime<br />Optional | When the type was changed.<br />**Allowable Values:**<br />Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| dispute\_details<br />object<br />Returned | The details of the dispute case.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/list-cases#_the_dispute_details_response_object">The dispute details response object</a>. |
| created\_time<br />datetime<br />Returned | The time when the dispute case was created.<br />**Allowable Values:**<br />Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| updated\_time<br />datetime<br />Returned | The time when the dispute case was last updated.<br />**Allowable Values:**<br />Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |

<h2 id="_the_dispute_details_response_object">
  The dispute\_details\_response object
</h2>

| Fields | Description |
| - | - |
| original\_transaction\_token<br />string<br />Returned | The token of the original transaction under dispute.<br />**Allowable Values:**<br />36 char max |
| original\_transaction\_id<br />integer<br />Returned | The ID of the original transaction under dispute.<br />**Allowable Values:**<br />36 char max |
| original\_transaction\_type<br />string<br />Returned | The type of the original transaction under dispute.<br />**Allowable Values:**<br />255 char max |
| dispute\_amount<br />number<br />Returned | The amount of funds under dispute.<br />**Allowable Values:**<br />Must be less than or equal to the original transaction amount. |
| dispute\_amount\_change\_reason<br />string<br />Returned | The reason the dispute amount has been changed from the transaction amount.<br />**Allowable Values:**<br />`MERCHANT_ISSUED_PARTIAL_REFUND`, `PARTIAL_DISPUTE`, `NOT_AS_DESCRIBED_PARTIAL`, `PARTIAL_SERVICE`, `PRORATED_REFUND`, `NOT_AUTHORIZED_FOR_FULL_AMOUNT` |
| currency\_code<br />string<br />Returned | The currency in which the original transaction was made. Currently, only 840 is supported.<br />There is a known caveat for multi-currency programs: disputes are created in the transaction currency as expected, but chargebacks might currently default to the program-level default currency rather than the transaction currency.<br />**Allowable Values:**<br />30 char max |
| dispute\_reason<br />string<br />Returned | The code describing the reason for the dispute.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/create-case#_the_dispute_details_dispute_reason_field">The dispute\_details.dispute\_reason field</a> table. |
| dispute\_state<br />string<br />Returned | The current dispute state. Once the case's state has been moved to `CHARGEBACK_INITIATED`, this field will be updated as it progresses in the backend lifecycle.<br />**Allowable Values:**<br />`INITIATED`, `REPRESENTMENT`, `PRE_ARBITRATION`, `ARBITRATION`, `CASE_WON`, `CASE_LOST`, `NETWORK_REJECTED`, `CLOSED`, `WRITTEN_OFF_ISSUER`, `WRITTEN_OFF_PROGRAM` |
| chargeback\_token<br />string<br />Returned | Indicates what is the associated chargeback in the legacy system. This is useful to map the current chargeback webhooks back to a dispute case. This field is populated once the case state has moved to `CHARGEBACK_INITIATED`. For Regulation E dispute cases, this value is returned after dispute case creation.<br />**Allowable Values:**<br />36 char max |
| network<br />string<br />Returned | The network where the transaction took place.<br />**Allowable Values:**<br />`VISA` |
| network\_case\_number<br />string<br />Returned | The network identifier for the dispute case.<br />**Allowable Values:**<br />A valid network case number. |
| acquirer\_fee<br />number<br />Returned | The acquirer fee for the transaction.<br />**Allowable Values:**<br />A valid number. |
| associated\_transaction\_selection\_required<br />boolean<br />Returned | Indicates whether there are any transactions related to the original transaction.<br />**Allowable Values:**<br />`true`, `false` |
| card\_token<br />string<br />Returned | Unique identifier that maps back to the card that made the original transaction.<br />**Allowable Values:**<br />36 char max |
| processing\_error\_type\_dispute\_details<br />object<br />Returned | An object providing details about processing error disputes.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/create-case#_the_processing_error_type_dispute_details_object">The processing\_error\_type\_dispute\_details object</a> table. |
| consumer\_dispute\_type\_dispute\_details<br />object<br />Returned | Indicates the latest error that has occurred while the case is processed.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/create-case#_the_consumer_dispute_type_dispute_details_object">The consumer\_dispute\_type\_dispute\_details object</a> table. |
| network\_case\_status\_details<br />object<br />Returned | Available once the case state has been successfully transitioned to `CHARGEBACK_INITIATED`.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/list-cases#_the_network_case_status_details_object">The network\_case\_status\_details object</a> table. |
| additional\_dispute\_details<br />object<br />Optional | An object providing any additional information for a case.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/create-case#_the_additional_dispute_details_object">The additional\_dispute\_details object</a> table. |
| fraud\_dispute\_type\_details<br />object<br />Returned | Provides any additional information for cases with a fraud dispute reason. Contains the `general_fraud_type_dispute_details` object, which contains the `chip_on_card` boolean value, which is set to true if the card used for the original transaction had a chip.<br />**Allowable Values:**<br />`true`, `false` |
| network\_failure\_response<br />string<br />Returned | Indicates the latest error that has occurred while the case is processed.<br />**Allowable Values:**<br />255 char max |
| fraud\_category\_type\_dispute\_details<br />object<br />Returned | Additional information regarding a previously submitted fraud report in the network.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/create-case#_the_fraud_category_type_dispute_details_object">The fraud\_category\_type\_dispute\_details object</a> table. |
| fraud\_classification\_type\_dispute\_details<br />object<br />Optional | Object that provides details about the fraud type classification to the Visa card network.<br />**Allowable Values:**<br />See the <a href="/docs/core-api/disputes-visa/create-case#_the_fraud_classification_type_dispute_details_object">fraud\_classification\_type\_dispute\_details object</a> table. |
| cardholder\_contact\_date<br />date<br />Returned | The date that the cardholder made initial contact regarding the dispute.<br />**Allowable Values:**<br />Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| provisional\_credit\_granted<br />boolean<br />Returned | Indicates whether the provisional credit was granted. Set to true whenever a credit has been granted through the `Cases` endpoint.<br />**Allowable Values:**<br />`true`, `false` |
| regulation\_type<br />string<br />Returned | The regulation type of the dispute case. For Regulation E cases, this value is `REG_E`.<br />**Allowable Values:**<br />255 char max |
| regulation\_details<br />object<br />Conditionally returned | Contains the Regulation E configuration that governs the dispute case throughout the lifecycle. Available only if the `expanded` query parameter was set to `regulation_details` in the query.<br />**Allowable Values:**<br />See <a href="/docs/core-api/disputes-visa/list-cases#_the_regulation_details_object">The regulation\_details object</a>. |

<h2 id="_the_network_case_status_details_object">
  The network\_case\_status\_details object
</h2>

| Fields | Description |
| - | - |
| network<br />string<br />Returned | Network where the original transaction originated and is being processed.<br />**Allowable Values:**<br />`VISA` |
| network\_case\_number<br />string<br />Returned | Network identifier for the case.<br />**Allowable Values:**<br />A valid network identifier. |
| case\_status<br />string<br />Returned | Network-specific value that represents the status of the case in the network.<br />**Allowable Values:**<br />A valid status value. |
| current\_case\_amount<br />number<br />Returned | Current amount that has been disputed in the network.<br />**Allowable Values:**<br />A valid number. |
| next\_actor<br />string<br />Returned | Who is currently expected to act upon the case.<br />**Allowable Values:**<br />`ISSUER`, `ACQUIRER`, `DISPUTE_COMPLETED`, `UNKNOWN` |
| days\_to\_act<br />integer<br />Returned | The number of days left to act for the `next_actor` before the dispute case defaults.<br />**Allowable Values:**<br />A valid integer. |
| last\_action\_date<br />date<br />Returned | When the case was last updated in the network.<br />**Allowable Values:**<br />Format: yyyy-MM-dd |
| case\_opened\_date<br />date<br />Returned | Date when the case was opened in the network.<br />**Allowable Values:**<br />Format: yyyy-MM-dd |
| last\_refresh\_date<br />date<br />Returned | When the case was last refreshed from the network to the Marqeta system.<br />**Allowable Values:**<br />Format: yyyy-MM-dd |
| allowable\_actions<br />string<br />Returned | The actions allowed for the dispute case in the current dispute state.<br />**Allowable Values:**<br />`SUBMIT`, `ACCEPT_AND_CLOSE`, `RESPOND_WITH_PREARB`, `RESPOND_WITH_PREARB_RESPONSE`, `RESPOND_WITH_ARB`, `WAIT`, `ALLOCATION_ACKNOWLEDGED`, `REPRESENTMENT_RECEIVED`, `PREARB_RECEIVED`, `PREARB_ACCEPTED`, `PREARB_DECLINED`, `PREARB_RESPONSE_DECLINED`, `ADJUSTMENT`, `CLOSE_WITH_CASE_WON`, `CLOSE_WITH_NETWORK_REJECTED` |

<h2 id="_the_regulation_details_object">
  The regulation\_details object
</h2>

| Fields | Description |
| - | - |
| pc\_grant\_days\_to\_act<br />string<br />Conditionally returned | The maximum number of days to grant provisional credit before the dispute case becomes out of compliance.<br />**Allowable Values:**<br />255 char max |
| pc\_perm\_days\_to\_act<br />string<br />Conditionally returned | The maximum number of days to reverse a cardholder's provisional credit. If a dispute case is still open with no outcome, the provisional credit cannot be reversed from the cardholder.<br />**Allowable Values:**<br />255 char max |
| pc\_reversed\_coms\_days\_to\_act<br />string<br />Conditionally returned | The maximum number of days to inform a cardholder that the provisional credit will be reversed from the day the case was attempted to be closed.<br />**Allowable Values:**<br />255 char max |
| pc\_reversed\_days\_to\_act<br />string<br />Conditionally returned | The number of business days that must elapse before the reversal of the provisional credit.<br />**Allowable Values:**<br />255 char max |

<h2 id="_sample_response_body_5">
  Sample response body
</h2>

```json JSON expandable lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": true,
  "data": [
    {
      "token": "string",
      "type": "DISPUTE",
      "memo": "Multiple browser submission",
      "program_short_code": "string",
      "user_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "business_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "state": "OPEN",
      "assignee": "string",
      "dispute_details": {
        "original_transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "original_transaction_type": "transaction_type",
        "dispute_amount": 120.49,
        "dispute_amount_change_reason": "MERCHANT_ISSUED_PARTIAL_REFUND",
        "currency_code": "840",
        "dispute_reason": "SERVICE_NOT_PROVIDED_MERCHANDISE_NOT_RECEIVED",
        "dispute_state": "INITIATED",
        "chargeback_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "network": "VISA",
        "network_case_number": "string",
        "acquirer_fee": 0,
        "associated_transaction_selection_required": "true",
        "card_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "network_failure_response": "string",
        "processing_error_type_dispute_details": {
          "late_presentment_details": {
            "account_status": "ACCOUNT_CLOSED"
          },
          "incorrect_transaction_code_details": {
            "how_is_transaction_code_incorrect": "CREDIT_INSTEAD_OF_REVERSAL_OR_ADJUSTMENT",
            "explain_why_the_credit_refund_was_processed_in_error": "string"
          },
          "incorrect_currency_details": {
            "incorrect_currency_reason": "CURRENCY_DIFFERENCE",
            "what_was_the_correct_currency": 0,
            "certification_that_the_cardholder_did_not_agree_to_dynamic_currency_conversion_and_did_not_make_an_active_choice": "string"
          },
          "incorrect_account_number_details": {
            "is_the_account_number_on_the_issuers_master_file": true,
            "does_the_account_number_on_the_receipt_match_the_cardholders_account_number_or_token": true
          },
          "incorrect_transaction_amount_details": {
            "what_is_the_amount_on_the_cardholders_receipt": 0,
            "what_is_the_currency_on_the_cardholders_receipt": "string"
          }
        },
        "consumer_dispute_type_dispute_details": {
          "service_not_provided_merchandise_not_received_details": {
            "detailed_description_of_what_was_purchased_and_explanation_of_the_dispute": "string",
            "expected_receipt_date": "2022-01-31",
            "expected_receipt_time": "2022-01-31",
            "did_cardholder_cancel_prior_to_the_expected_date": true,
            "cancellation_date": "2022-01-31",
            "cancellation_reason": "string",
            "did_cardholder_attempt_to_resolve_dispute_with_merchant": true,
            "is_attempt_to_resolve_prohibited_by_local_law_or_regulations": true,
            "provide_details_of_local_law_or_regulations": "string",
            "merchandise_or_services": "MERCHANDISE SERVICES",
            "was_merchandise_delivered_to_wrong_location": true,
            "address_of_agreed_location": "string",
            "did_cardholder_return_merchandise": true,
            "date_cardholder_returned_merchandise": "2022-01-31",
            "date_merchant_received_returned_merchandise": "2022-01-31",
            "did_cardholder_attempt_to_return_merchandise": true,
            "date_of_attempted_return": "2022-01-31",
            "explain_how_merchandise_was_returned": "string",
            "third_party_gift_card_indicator": true,
            "visa_commercial_card_virtual_account_indicator": true,
            "did_virtual_account_holder_suffer_financial_loss": true,
            "did_merchant_cancel_services": true,
            "date_merchant_cancelled_services": "2022-01-31",
            "explanation_dispute_prior_expected_delivery_date": "string"
          },
          "cancelled_recurring_transaction_details": {
            "cancellation_date": "2022-01-31",
            "cancellation_reason": "string",
            "date_issuer_informed_merchant_of_account_closure": "2022-01-31"
          },
          "not_as_described_or_defective_merchandise_details": {
            "not_as_described_or_defective": "NOT_AS_DESCRIBED DEFECTIVE",
            "merchandise_or_services": "MERCHANDISE SERVICES",
            "date_the_cardholder_first_notified_the_issuer_of_the_dispute": "2022-01-31",
            "did_the_cardholder_attempt_to_resolve_the_dispute_with_the_merchant": true,
            "is_attempt_to_resolve_prohibited_by_local_law_or_regulations": true,
            "provide_details_of_local_law_or_regulations": "string",
            "did_the_cardholder_return_the_merchandise": true,
            "date_cardholder_returned_the_merchandise": "2022-01-31",
            "date_merchant_received_the_returned_merchandise": "2022-01-31",
            "return_method": "FACE_TO_FACE",
            "tracking_number": "string",
            "date_of_attempted_return": "2022-01-31",
            "provide_a_detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "string",
            "did_the_cardholder_attempt_to_return_the_merchandise": true,
            "explain_how_the_merchandise_was_returned": "string",
            "cardholder_merchant_previous_negotiation_evidence": true,
            "explain_prev_negotiation": "string",
            "when_negotiations_begin": "2022-01-31",
            "date_merchandise_or_service_was_received": "2022-01-31",
            "does_the_dispute_involve_merchandise_or_services_provided_that_do_not_match_the_merchants_verbal_description": true,
            "did_the_merchandise_or_services_differ_from_what_was_described_on_the_receipt": true,
            "provide_details_of_what_was_ordered_and_not_as_described": "string",
            "did_the_cardholder_cancel_the_services": true,
            "cancellation_date": "2022-01-31",
            "cancellation_reason": "string",
            "what_was_ordered_and_how_it_was_damaged_or_defective": "string",
            "date_merchandise_was_received": "2022-01-31"
          },
          "credit_not_processed_details": {
            "was_a_credit_voucher_voided_transaction_receipt_or_refund_acknowledgement_given": true,
            "is_the_credit_voucher_transaction_receipt_or_refund_acknowledgement_dated": true,
            "credit_voucher_transaction_receipt_or_refund_acknowledgement_date": "2022-01-31",
            "date_cardholder_returned_cancelled_merchandise": "string"
          },
          "cancelled_merchandise_or_services_details": {
            "merchandise_or_services": "MERCHANDISE SERVICE",
            "describe_what_was_purchased": "string",
            "date_cardholder_received_or_expected_to_receive_merchandise": "2022-01-31",
            "did_the_cardholder_attempt_to_resolve_the_dispute_with_the_merchant": true,
            "is_attempt_to_resolve_prohibited_by_local_law_or_regulations": true,
            "provide_details_of_local_law_or_regulations": "string",
            "did_the_cardholder_return_the_merchandise": true,
            "date_of_return": "2022-01-31",
            "date_merchant_received_returned_merchandise": "2022-01-31",
            "return_method": "FACE_TO_FACE",
            "tracking_number": "string",
            "explain_how_the_merchandise_was_returned": "string",
            "did_the_cardholder_attempt_to_return_the_merchandise": true,
            "date_of_attempted_return": "2022-01-31",
            "detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "2022-01-31",
            "did_cardholder_cancel": true,
            "cancellation_date": "2022-01-31",
            "cancellation_reason": "string",
            "was_cancellation_policy_provided": true,
            "type_of_service": "TIMESHARE",
            "date_of_service_or_expected_service": "2022-01-31",
            "cancelled_guaranteed_reservation_certification_selection": "string"
          }
        },
        "fraud_dispute_type_details": {
          "general_fraud_type_dispute_details": {
            "chip_on_card": true
          }
        },
        "fraud_classification_type_dispute_details": {
          "fraud_type_classification": "PURCHASE_SCAM"
        },
        "network_case_status_details": {
          "network": "VISA",
          "network_case_number": "string",
          "case_status": "string",
          "current_case_amount": 0,
          "next_actor": "ISSUER",
          "days_to_act": 0,
          "last_action_date": "2022-01-31T18:57:42.890Z",
          "case_opened_date": "2022-01-31",
          "last_refresh_date": "2022-01-31T18:57:42.890Z",
          "allowable_actions": [
            "SUBMIT"
          ]
        },
        "fraud_category_type_dispute_details": {
          "fraud_report_details": {
            "fraud_type": "LOST",
            "fraud_type_code": "string",
            "fraud_report_id": 0,
            "fraud_type_category": "string"
          }
        }
      },
      "created_time": "2022-01-31T18:57:42.890Z",
      "updated_time": "2022-01-31T18:57:42.890Z"
    }
  ]
}
```


## Related topics

- [List dispute cases](/docs/core-api/disputes-mastercard/list-cases.md)
- [List dispute case transitions](/docs/core-api/disputes-visa/list-case-transitions.md)
- [List dispute case milestones](/docs/core-api/disputes-visa/list-case-milestones.md)
- [Disputes (Visa) Overview](/docs/core-api/disputes-visa.md)
- [Disputes (PULSE) Overview](/docs/core-api/disputes-pulse.md)