---
title: "Get dispute"
method: GET
path: "/disputes/{dispute_id}"
tags: ["Disputes API"]
---

# Get dispute

`GET /disputes/{dispute_id}`

## Request

- Base URL: `https://sandbox.affirm.com/api/v3`
- URL: `https://sandbox.affirm.com/api/v3/disputes/{dispute_id}`
- Auth: none declared

## Path parameters

- `dispute_id` string, required

## Response `200`

Success

- object
  - `token` string
  - `id` string: ID of dispute
  - `transaction_id` string: ID of associated charge with the dispute
  - `order_id` string: Merchant reference for associated order with the dispute
  - `open` boolean: Indicates if dispute is open or not.
  - `transaction_amount` integer: Total amount in cents of transaction which is being disputed
  - `dispute_amount` integer: Dispute amount in the smallest denomination of the currency, such as cents
  - `currency` string: The local currency of the dispute, must be a valid subset of the ISO 4217 currency code
  - `dispute_reason` 'cancellation_or_return_not_processed' | 'incorrect_amount' | 'product_not_received' | 'product_unacceptable' | 'cancellation_not_processed' | 'return_not_processed': Dispute reason
  - `status` 'action_required_merchant' | 'no_merchant_action_needed' | 'closed_customer_favor' | 'closed_merchant_favor' | 'closed_customer_partial_favor': Current dispute status
  - `response_due_by` string, date-time: Deadline by which merchant must respond to the dispute, in ISO 8601 UTC format
  - `created` string, date-time: Timestamp indicating when the dispute was opened, in ISO 8601 UTC format
  - `updated` string, date-time: Timestamp indicating when the dispute was last updated, in ISO 8601 UTC format
  - `comments` string[]: Text blob from the customer describing the complaint reason for the dispute
  - `attached_files` object[]: Array of attached files to dispute
    - `file_name` string: name of file
    - `file_url` string: presigned_url for file that expires after 60 minutes
  - `closed_at` string, date-time: Timestamp indicating when the dispute was closed, in ISO 8601 UTC format
  - `evidence_received_at` string, date-time: Timestamp indicating when evidence was received for this dispute, in ISO 8601 UTC format
  - `extra_evidence` ExtraEvidence[]
    - `shipping_info` object
      - `company_name` string: Carrier company for shipment of order
      - `tracking_number` string: Carrier company tracking number for shipment of order
    - `communication_info` object
      - `contact_type` 'already_contacted' | 'no_contact' | 'no_response': Type of contact between customer and merchant prior to dispute opening
      - `merchant_contact_name` string: Name of merchant contact that customer interacted with before opening the dispute
      - `first_contact_date` string, date: First time customer contacted merchant, as YYYY-MM-DD
      - `last_contact_date` string, date: Last time customer contacted merchant, as YYYY-MM-DD
    - `return_info` object
      - `type` 'all' | 'partial' | 'none' | 'not_accepted': Type of return
      - `return_date` string, date: Date of return, as YYYY-MM-DD
      - `method` 'mail' | 'in_store': Method of return
      - `shipping_delivery` string, date: Date of shipment delivery as YYYY-MM-DD
    - `cancellation_info` object
      - `cancellation_status` 'Customer_cancelled_entire_order' | 'Customer_cancelled_part_of_order' | 'Merchant_cancelled_entire_order' | 'Merchant_cancelled_part_of_order' | 'Attempted_cancellation_not_accepted' | 'Not_cancelled'
      - `cancellation_date` string, date: Date of cancellation, as YYYY-MM-DD
      - `cancellation_method` 'Cancelled_online' | 'Cancelled_in_store'
      - `company_name` string: Carrier company for shipment of return
      - `tracking_number` string: Carrier company tracking number for shipment of order
      - `shipping_delivery` string, date: Date of shipment delivery, as YYYY-MM-DD
      - `store_address` string: Store address for cancelled order
  - `transition_logs` object[]: A list of all dispute events corresponding to the dispute
    - `type` 'created' | 'customer_evidence_added' | 'merchant_evidence_added' | 'merchant_more_evidence_required' | 'adjudicated_customer_fault' | 'adjudicated_merchant_fault': Type of the dispute state transition denoted by the dispute event
    - `created` string, date-time: Timestamp indicating when the dispute event was opened, in ISO 8601 UTC format

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/affirm/apis/affirm-disputes-api.md) - [All operations](https://skmtc.dev/affirm/apis/affirm-disputes-api/llms.txt) - [OpenAPI document](https://skmtc.dev/affirm/apis/affirm-disputes-api/revisions/c6ae26b115a4?raw)