> ## 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.
**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. |
| 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](/docs/core-api/disputes-pulse/retrieve-case.md)
- [Retrieve dispute case transition](/docs/core-api/disputes-visa/retrieve-case-transition.md)
- [Create dispute case content](/docs/core-api/disputes-pulse/create-case-content.md)
- [Retrieve network dispute transition](/docs/core-api/disputes-mastercard/retrieve-network-transition.md)
- [List dispute case transitions](/docs/core-api/disputes-visa/list-case-transitions.md)