---
title: "Get an Issuing dispute"
method: GET
path: "/issuing/disputes/{disputeId}"
tags: ["Issuing disputes"]
---

# Get an Issuing dispute

`GET /issuing/disputes/{disputeId}`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/disputes/{disputeId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:disputes-read`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/disputes/:disputeId/get.ts> (a function with typed inputs; its response is checked against the schema)

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p>
Retrieve the details of an [Issuing dispute](https://www.checkout.com/docs/card-issuing/manage-cardholder-transactions/manage-issuing-disputes).

## Path parameters

- `disputeId` string, required: The unique identifier for the Issuing dispute.

## Response `200`

Issuing dispute retrieved successfully

- GetDisputeResponse: The client's dispute view.
  - `id` string: The unique identifier for the Issuing dispute.
  - `reason` string: The four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes#Mastercard) you provide for the chargeback.
  - `disputed_amount` IssuingTransactionAmount
    - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
    - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
  - `status` 'created' | 'canceled' | 'processing' | 'action_required' | 'won' | 'lost': The [dispute status](https://www.checkout.com/docs/developer-resources/codes/issuing-dispute-codes) as returned to the client.
  - `status_reason` '' | 'expired' | 'chargeback_pending' | 'chargeback_change_requested' | 'chargeback_evidence_invalid_or_insufficient' | 'chargeback_processed' | 'chargeback_rejected' | 'chargeback_reversal_pending' | 'chargeback_reversed' | 'chargeback_response_accepted' | 'prearbitration_pending' | 'escalation_change_requested' | 'prearbitration_evidence_invalid_or_insufficient' | 'prearbitration_processed' | 'prearbitration_rejected' | 'prearbitration_reversal_pending' | 'prearbitration_reversed' | 'prearbitration_response_accepted' | 'arbitration_pending' | 'arbitration_processed' | 'presentment_reversed': The status reason as returned to the client. An empty string indicates no status reason currently applies.
  - `transaction_id` string: The transaction's unique identifier.
  - `presentment_message_id` string: The message's unique Checkout.com identifier.
  - `merchant` IssuingDisputeMerchant
    - `id` string: The merchant's identifier. This can vary from one acquirer to another.
    - `name` string: The merchant's name.
    - `city` string: The city where the merchant is located.
    - `state` string: The state where the merchant is located (US only).
    - `country_code` string: The two-digit [country code](https://www.checkout.com/docs/developer-resources/codes/country-codes) where the merchant is located.
    - `category_code` string: The merchant's [category code](https://www.checkout.com/docs/developer-resources/testing/codes/merchant-category-codes) for the disputed transaction.
    - `evidence` IssuingFileId[]: Any evidence submitted by the merchant during the dispute lifecycle.
  - `created_on` string, date-time: The date and time when the dispute was created, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
  - `modified_on` string, date-time: The date and time when the dispute was last modified, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
  - `action_details` IssuingDisputeActionDetails: Provides instructions on the amendments required before the dispute can proceed, if the dispute `status` is `action_required`. Use the <a target="_blank" href="https://api-reference.checkout.com/tag/Issuing-disputes#operation/amendDispute">Amend an Issuing dispute</a> endpoint to submit your amendments. Use the correct endpoint to send your updates as requested.
    - `instructions` string: The amendments required before the dispute can proceed. For example, if you need to provide a reason code, or update the submitted evidence.
    - `last_action_response` string: Specifies whether the dispute was previously amended and an action response was provided.
  - `chargeback` IssuingDisputeChargeback: The dispute details at the chargeback stage.
    - `submitted_on` string, date-time: The date and time when the chargeback was successfully submitted to the card scheme, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `reason` string: The four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes#Mastercard) you provide for the chargeback.
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `evidence` object[]: Your evidence for the chargeback.
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
    - `justification` string: A brief description of why the dispute is being raised. This is forwarded to the scheme.
  - `representment` IssuingDisputeSecondPresentment: The information provided by the merchant when they reject the chargeback and send a representment.
    - `received_on` string, date-time: The date and time when you received the representment, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `evidence` object[]: The evidence provided by the merchant against the chargeback.
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
  - `pre_arbitration` IssuingDisputePreArbitration: The dispute details at the pre-arbitration stage.
    - `submitted_on` string, date-time: The date and time when the pre-arbitration was successfully escalated to the card scheme, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `evidence` object[]: The evidence relating to the Issuing dispute provided at the pre-arbitration stage.
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `reason_change` IssuingDisputeReasonChange: The change to the dispute reason and your justification for changing it.
      - `reason` string, required: The updated four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes) for the chargeback.
      - `justification` string, required: Your justification for changing the dispute reason. Allowed characters are: - Letters - Numbers - Spaces - The following special characters: <br> `~!@#$%^&*()_+{}|:"<>?,./;'[]-=`.
    - `justification` string: Your justification for escalating the dispute to pre-arbitration.
    - `merchant_responded_on` string, date-time: The date and time when the merchant provided evidence against the pre-arbitration, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `merchant_evidence` object[]
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
  - `arbitration` IssuingDisputeArbitration: The dispute details during the arbitration stage.
    - `submitted_on` string, date-time: The date and time when the arbitration was successfully escalated to the card scheme, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `justification` string: Your justification for escalating the dispute to arbitration.
    - `decided_on` string, date-time: The date and time when the card scheme decided the arbitration case, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
  - `_links` object: The links related to the dispute.
    - `self` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `card` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `cardholder` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `transaction` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `amend` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `escalate` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `cancel` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource

## Other responses

- `401`: Unauthorized Request
- `403`: Forbidden
- `404`: Issuing dispute not found
- `406`: Not Acceptable
- `415`: Unsupported Media Type
- `429`: Too Many Requests
- `default`: Issuing dispute response retrieved successfully

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)