---
title: "Get Dispute"
method: GET
path: "/v1/disputes/{disputeId}"
tags: ["Disputes"]
---

# Get Dispute

`GET /v1/disputes/{disputeId}`

Use this endpoint to fetch information from a single dispute, based on a Dispute ID

## Path parameters

- `disputeId` string, required

## Headers

- `Request-Reference` string

## Response `200`

Success

- DisputeResponse — Dispute resource response. Contains dispute details and HATEOAS links. Links returned: 'self' (link to the dispute resource), 'payment_charge' (link to the associated payment charge)
  - `id` string, required — The unique dispute identifier.
  - `amount` Amount, required
    - `value` integer, required
    - `currency` string, required
  - `merchantPaymentChargeReference` string, required — A merchant-defined identifier that represents a payment charge.
  - `paymentChargeId` string, required — The payment charge identifier.
  - `paymentSource` 'GAPI' | 'SAPI' | 'ACI' — Payment source for the payment
  - `merchantId` string, required — The merchant ID for the payment.
  - `phase` 'PRE_DISPUTE' | 'DISPUTE' | 'PRE_ARBITRATION' | 'ARBITRATION', required — Current phase of the dispute.
  - `status` 'OPEN' | 'ACCEPT_PROCESSING' | 'CHALLENGE_PROCESSING' | 'OFFER_PROCESSING' | 'UNDER_REVIEW' | 'LOST' | 'WON' | 'OFFER_ACCEPTED' | 'OFFER_REJECTED', required — Current status of the dispute
  - `allowedActions` union[] — Actions available to the merchant
    - union
      - AcceptActionDto — Defines parameters for the ACCEPT action, used when the merchant chooses to accept a dispute.
        - `dueBy` string, date-time — Date and time by which this action must be completed.
        - `messageConfig` MessageConfigDto — Message configuration details
          - `required` boolean, required — Defines the message requirement
          - `minLength` integer, required — Minimal length of the message
          - `maxLength` integer, required — Maximal length of the message
        - `type` 'ACCEPT', required — Accept action type
        - `dueByInDays` integer — Number of days by when this action is due. Deprecated: use dueBy instead.
        - `resolutions` string[] — The resolution options available for the action. If none are specified, no resolution options are required.
      - ChallengeActionDto — Challenge action configuration
        - `dueBy` string, date-time — Date and time by which this action must be completed.
        - `messageConfig` MessageConfigDto — Message configuration details
          - `required` boolean, required — Defines the message requirement
          - `minLength` integer, required — Minimal length of the message
          - `maxLength` integer, required — Maximal length of the message
        - `type` 'CHALLENGE', required — Challenge action type
        - `dueByInDays` integer — Number of days by when this action is due. Deprecated: use dueBy instead.
        - `filesRequired` boolean — Are files required for the challenge? if yes, file upload capability config should also be provided.
        - `amountRequired` boolean — Is the amount required for the challenge. If not specified, the full disputed amount will be challenged.
      - OfferActionDto — Defines parameters for the OFFER action, used when the merchant chooses to make an offer on a dispute.
        - `dueBy` string, date-time — Date and time by which this action must be completed.
        - `messageConfig` MessageConfigDto — Message configuration details
          - `required` boolean, required — Defines the message requirement
          - `minLength` integer, required — Minimal length of the message
          - `maxLength` integer, required — Maximal length of the message
        - `type` 'OFFER', required — Offer action type
        - `dueByInDays` integer — Number of days by when this action is due. Deprecated: use dueBy instead.
  - `allowedCapabilities` union[] — Additional capabilities available to the merchant
    - union
      - FileUploadCapabilityDto — File upload operation configuration
        - `statusAllowedIn` string[] — The status in which this capability is allowed
        - `url` string — URL to perform this capability
        - `type` 'UPLOAD_FILE', required — File upload operation type.
        - `allowedFileTypes` string — File types allowed for upload as comma separated values
        - `maxFileSizeInMb` number — Maximum individual file size allowed (in Mb)
        - `maxNumberOfFiles` integer — Total number of files allowed
      - PostMessageCapabilityDto — Post messages operation configuration
        - `statusAllowedIn` string[] — The status in which this capability is allowed
        - `url` string — URL to perform this capability
        - `type` 'POST_MESSAGES', required — Post messages operation type
        - `minLength` integer — Minimum length of the message content
        - `maxLength` integer — Maximum length of the message content
  - `files` FileResponse[] — Files associated with the dispute
    - `id` string — The unique file identifier starting with file_.
    - `name` string — Name of the file.
    - `createdAt` string, date-time — Date and time when the file was created.
    - `phase` 'PRE_DISPUTE' | 'DISPUTE' | 'PRE_ARBITRATION' | 'ARBITRATION', required — Phase when the file was added.
    - `sender` 'MERCHANT' | 'PROVIDER', required — Sender of the file.
    - `status` 'PENDING' | 'FAILED' | 'AVAILABLE' | 'SYNCED_WITH_PROVIDER' — Status of the file.
    - `_links` Links
  - `reason` DisputeReason
    - `code` string, required — Reason code for the dispute
    - `message` string — Reason description for the dispute
  - `closingReason` string — Reason provided by the provider for closing the dispute (e.g., accepted by merchant, closed by consumer)
  - `closingNote` string — A note provided while closing the dispute.
  - `openedAt` string, date-time — Date and time when the dispute was created by the consumer.
  - `createdAt` string, date-time — Date and time when the dispute was created in PPRO.
  - `updatedAt` string, date-time — Date and time when the dispute was last updated.
  - `openingNote` string — A note provided when opening the dispute by the consumer.
  - `messages` MessageDto[] — Messages added by consumers or merchants for this dispute.
    - `content` string, required — The message content
    - `sender` 'MERCHANT' | 'PROVIDER' — Sender of the message
    - `phase` 'PRE_DISPUTE' | 'DISPUTE' | 'PRE_ARBITRATION' | 'ARBITRATION' — Phase of the dispute when message was created
    - `createdAt` string, date-time, required — Date and time when the message was created
  - `chargebacks` ChargebackDetails[] — Chargebacks associated with this dispute.
    - `id` string — The unique identifier.
    - `amount` Amount
      - `value` integer, required
      - `currency` string, required
    - `reason` 'PDSP_AUTH_001' | 'PDSP_AUTH_002' | 'PDSP_AUTH_003' | 'PDSP_AUTH_004' | 'PDSP_PROD_001' | 'PDSP_PROD_002' | 'PDSP_PROD_003' | 'PDSP_PROD_004' | 'PDSP_PROD_005' | 'PDSP_CANC_001' | 'PDSP_CANC_002' | 'PDSP_CANC_003' | 'PDSP_CANC_004' | 'PDSP_SUBS_001' | 'PDSP_SUBS_002' | 'PDSP_SUBS_003' | 'PDSP_SUBS_004' | 'PDSP_GEN_001' | 'PDSP_GEN_002' | 'PDSP_GEN_003' — Defines the reason.
    - `paymentChargeId` string — The payment charge identifier.
    - `disputeId` string — The unique identifier of the associated dispute.
    - `transferStatus` 'EXPECTED' | 'FAILED' | 'SETTLED' — Status of the transfer for settlement tracking.
    - `createdAt` string, date-time — Date and time when the entity was created in PPRO.
    - `updatedAt` string, date-time — Date and Time when the entity was last updated.
    - `_links` object
  - `chargebackReversals` ChargebackDetails[] — Chargeback reversals associated with this dispute.
    - `id` string — The unique identifier.
    - `amount` Amount
      - `value` integer, required
      - `currency` string, required
    - `reason` 'PDSP_AUTH_001' | 'PDSP_AUTH_002' | 'PDSP_AUTH_003' | 'PDSP_AUTH_004' | 'PDSP_PROD_001' | 'PDSP_PROD_002' | 'PDSP_PROD_003' | 'PDSP_PROD_004' | 'PDSP_PROD_005' | 'PDSP_CANC_001' | 'PDSP_CANC_002' | 'PDSP_CANC_003' | 'PDSP_CANC_004' | 'PDSP_SUBS_001' | 'PDSP_SUBS_002' | 'PDSP_SUBS_003' | 'PDSP_SUBS_004' | 'PDSP_GEN_001' | 'PDSP_GEN_002' | 'PDSP_GEN_003' — Defines the reason.
    - `paymentChargeId` string — The payment charge identifier.
    - `disputeId` string — The unique identifier of the associated dispute.
    - `transferStatus` 'EXPECTED' | 'FAILED' | 'SETTLED' — Status of the transfer for settlement tracking.
    - `createdAt` string, date-time — Date and time when the entity was created in PPRO.
    - `updatedAt` string, date-time — Date and Time when the entity was last updated.
    - `_links` object
  - `_links` Links

## Other responses

- `400` — Bad Request
- `404` — Not found
- `409` — Target event could not be reset due to a concurrent update.
- `500` — Internal Server Error

---

[API](https://skmtc.net/ppro/apis/payment-charges.md) · [All operations](https://skmtc.net/ppro/apis/payment-charges/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ppro/payment-charges/revisions/112e8bb4c815/schema)