> ## 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.

# Retrieve dispute case

> Retrieve a specific dispute case.

GET/cases/\{token}

Retrieve a specific dispute case.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | The token of the dispute case to retrieve. **Allowable Values:**  36 char max |

## Query parameter

| Fields | Description |
| - | - |
| expand string  Optional | If the `regulation_type` field is set to `REG_E`, adds the `regulation_details` fields inside `dispute_details` in the response. For more information, see [The regulation\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/list-dispute-cases-visa.md#_the_regulation_details_object). **Allowable Values:**  `regulation_details` |

## Response body

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

```json JSON expandable lines wrap theme={null}
{
  "count": 0,
  "start_index": 0,
  "end_index": 0,
  "is_more": true,
  "data": [
    {
      "token": "string",
      "type": "DISPUTE",
      "memo": "string",
      "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": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "dispute_amount": 0,
        "dispute_amount_change_reason": "MERCHANT_ISSUED_PARTIAL_REFUND",
        "currency_code": "string",
        "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-03-21",
            "expected_receipt_time": "2022-03-21",
            "did_cardholder_cancel_prior_to_the_expected_date": true,
            "cancellation_date": "2022-03-21",
            "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-03-21",
            "date_merchant_received_returned_merchandise": "2022-03-21",
            "did_cardholder_attempt_to_return_merchandise": true,
            "date_of_attempted_return": "2022-03-21",
            "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-03-21",
            "explanation_dispute_prior_expected_delivery_date": "string"
          },
          "cancelled_recurring_transaction_details": {
            "cancellation_date": "2022-03-21",
            "cancellation_reason": "string",
            "date_issuer_informed_merchant_of_account_closure": "2022-03-21"
          },
          "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-03-21",
            "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-03-21",
            "date_merchant_received_the_returned_merchandise": "2022-03-21",
            "return_method": "FACE_TO_FACE",
            "tracking_number": "string",
            "date_of_attempted_return": "2022-03-21",
            "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-03-21",
            "date_merchandise_or_service_was_received": "2022-03-21",
            "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-03-21",
            "cancellation_reason": "string",
            "what_was_ordered_and_how_it_was_damaged_or_defective": "string",
            "date_merchandise_was_received": "2022-03-21"
          },
          "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-03-21",
            "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-03-21",
            "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-03-21",
            "date_merchant_received_returned_merchandise": "2022-03-21",
            "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-03-21",
            "detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "2022-03-21",
            "did_cardholder_cancel": true,
            "cancellation_date": "2022-03-21",
            "cancellation_reason": "string",
            "was_cancellation_policy_provided": true,
            "type_of_service": "TIMESHARE",
            "date_of_service_or_expected_service": "2022-03-21",
            "cancelled_guaranteed_reservation_certification_selection": "string"
          }
        },
        "fraud_dispute_type_details": {
          "general_fraud_type_dispute_details": {
            "chip_on_card": true
          }
        },
        "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-03-21T15:46:20.825Z",
          "case_opened_date": "2022-03-21",
          "last_refresh_date": "2022-03-21T15:46:20.825Z",
          "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-03-21T15:46:20.825Z",
      "updated_time": "2022-03-21T15:46:20.825Z"
    }
  ]
}
```


## Related topics

- [Retrieve dispute case](https://www.marqeta.com/docs/core-api/disputes-mastercard/dispute-cases-mastercard/retrieve-dispute-case-mastercard.md)
- [Retrieve dispute case transition](https://www.marqeta.com/docs/core-api/disputes-mastercard/dispute-case-transitions-mastercard/retrieve-dispute-case-transition-mastercard.md)
- [Dispute Cases (Mastercard) Overview](https://www.marqeta.com/docs/core-api/disputes-mastercard/dispute-cases-mastercard.md)
- [Dispute Cases (PULSE) Overview](https://www.marqeta.com/docs/core-api/disputes-pulse/dispute-cases-pulse.md)
- [Dispute Cases (Visa) Overview](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa.md)
