> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a Dispute With ID (With Expanded Payments Details)

> **GET** `/v1/disputes/:id?expand[]=payment`

Use this endpoint to retrieve the details of a specific dispute using expanded payments details.

### Request

```curl: Curl theme={null}
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X GET https://dashboard.dev.razorpay.in/app/disputes/disp_K8bVLppJ8zp5Wp?expand[]=payment \
-H "Content-Type: application/json"
```

### Response

````json: Success theme={null}
{
   "status_code":200,
   "success":true,
   "data":{
      "id":"disp_K8bVLppJ8zp5Wp",
      "entity":"dispute",
      "payment_id":"pay_K74a54NSclvx1M",
      "amount":36800,
      "currency":"INR",
      "amount_deducted":0,
      "gateway_dispute_id":"testtwo",
      "reason_code":"2",
      "reason_description":"live test",
      "respond_by":1661711400,
      "status":"under_review",
      "phase":"chargeback",
      "comments":null,
      "evidence":{
         "amount":368,
         "summary":"testing",
         "submitted_at":1661159542,
         "shipping_proof":null,
         "billing_proof":null,
         "cancellation_proof":null,
         "customer_communication":null,
         "proof_of_service":[
            "doc_K8cgi0fgjXk0En"
         ],
         "explanation_letter":null,
         "refund_confirmation":[
            "doc_K8chcnednNAcrD"
         ],
         "access_activity_log":null,
         "refund_cancellation_policy":null,
         "terms_and_conditions":null,
         "others":[
            {
               "type":"second",
               "document_ids":[
                  "doc_K8cIsvjyHY5KuO"
               ]
            }
         ]
      },
      "lifecycle":[
         {
            "change":{
               "new":{
                  "status":"under_review"
               },
               "old":{
                  "status":"open"
               }
            },
            "user_id":"AlNVTJfGQwKf7O",
            "created_at":1661159543,
            "merchant_id":"AlNVTRJpqd9sqB"
         }
      ],
      "created_at":1661154932,
      "reason":{
         "gateway_code":"2",
         "gateway_description":"livetest",
         "code":"2",
         "description":"live test",
         "network":"Amex"
      },
      "transaction":null
   }
}
```json: Failure
{
  "status_code":400,
  "success":false,
  "errors":[
    "Value of each expand must be one of following types: payment, transaction.settlement",
    "Status Code: 400"
  ]
}
````

### Parameters

`id` *mandatory*
: `string` The unique identifier of the dispute.

### Parameters

`expand[]=payment` *optional*
: `string` Use to expand the payments of a dispute.

### Parameters

`id`
: `string` The unique identifier of the dispute generated by Razorpay. For example, `disp_AHfqOvkldwsbqt`.

`entity`
: `string` Indicates the type of entity. In this case, it is `dispute`.

`payment_id`
: `string` The unique identifier of the payment against which the dispute was created. For example, `pay_EsyWjHrfzb59eR`.

`amount`
: `integer` Amount, in currency subunits, for which the dispute was created.

`currency`
: `string` 3-letter ISO currency code associated with the amount. Check the list of [supported currencies](/payments/international-payments#supported-currencies).

`amount_deducted`
: `integer` The amount, in currency subunits, deducted from your Razorpay current balance when the dispute is `lost`. This amount will be `0` unless the status of dispute is updated to `lost`. Know about the different [states of disputes](/payments/disputes#dispute-states).

`reason_code`
: `string` Code associated with the reason for the dispute.

`reason_description`
: `string` A brief description of the reason for dispute.

`respond_by`
: `integer` Unix timestamp by which a response should be sent to the customer.

`status`
: `string` The status of the dispute. Possible statuses are:

* `open`: Indicates that the dispute has been created.
* `under_review`: Indicates that the issuing bank is reviewing the dispute.
* `won`: Indicates that the bank has accepted the remedial documents, and you have won the chargeback.
* `lost`: Indicates that the bank did not accept the remedial documents, and you have lost the chargeback.
* `closed`: Indicates that the fraudulent transaction was closed after you provided either the transaction details or made a refund to the customer.

`phase`
: `string` Phase associated with the dispute. Possible phases are:

* `fraud`: A dispute raised by the bank when it suspects a transaction to be fraudulent based on the risk analysis.
* `retrieval`: A request initiated by the customer with their issuer bank for additional information about a transaction.
* `chargeback`: A refund claim initiated by the customers with their issuer banks. In such cases, the bank starts an official inquiry.
* `pre_arbitration`: A chargeback that you have won is challenged by the customer for the second time.
* `arbitration`: A chargeback that you have won is challenged for a third time by the customer and the card networks directly getting involved.

`created_at`
: `integer` Unix timestamp when the dispute was created.

`evidence`
: `object` Provides details of the evidence submitted/saved for contesting a dispute. Use the [Documents API](/api/documents) to securely share documents with Razorpay.

`amount`
: `integer` The contested amount in currency subunits, for which evidence is provided. The value can vary from `0` to the dispute amount. The default value is the dispute amount.

`summary`
: `string` The explanation provided by you for contesting the dispute. It can have a maximum length of 1000 characters.

`shipping_proof`
: `list` List of document ids which serves as proof that the product was shipped to the customer at their provided address. It should show their complete shipping address, if possible.

`billing_proof`
: `list` List of document ids which serves as proof of order confirmation, such as a receipt.

`cancellation_proof`
: `list` List of document ids that serves as proof that this product/service was cancelled.

`customer_communication`
: `list` List of document ids listing any written/email communication from the customer confirming that the customer received the product/service or is satisfied with the product/service.

`proof_of_service`
: `list` List of document ids showing proof of service provided to the customer.

`explanation_letter`
: `list` (List of document ids) Any letter(s) from you specifying information pertinent to the dispute/payment that needs to be considered for processing the dispute.

`refund_confirmation`
: `list` List of document ids showing proof that the refund had been provided to the customer.

`access_activity_log`
: `list` List of document ids of any server or activity logs which prove that the customer accessed or downloaded the purchased digital product.

`refund_cancellation_policy`
: `list` List of document ids listing your refund and/or cancellation policy, as shown to the customer.

`term_and_conditions`
: `list` List of document ids listing your sales terms and conditions, as shown to the customer.

`others`
: `list` Specifies the evidence documents to be uploaded as a part of contesting a dispute. It is a list of tuples consisting of the following:

`type`
: `string` Describes the custom type of evidence document(s) provided.

`document_ids`
: `list` List of document ids corresponding to the customer evidence type.

```json: Example theme={null}
[
  {
    "type": "receipt_signed_by_customer",
    "document_ids": [
      "doc_EFtmUsbwpXwBH7",
      "doc_EFtmUsbwpXwBH6"
    ]
  }  
]
```

`submitted_at`
: `integer` Unix timestamp when the dispute was last submitted by you (for review) to Razorpay. The default value is `null`.

### Errors

The id provided does not exist.

* code: 400
* description: - A wrong prefix is used.

- The dispute id does not exist or does not belong to the requestor.

* solution: - The dispute id must start with `disp_`.

- Use a valid dispute id that belongs to the requestor.

\_id is not a valid id.

* code: 400
* description: - The id is not 14 characters long.

- The id is not alphanumeric.

* solution: Use a valid dispute id.

Value of each expand must be one of following types: payment, transaction.settlement

* code: 400
* description: The value of the `expand` query parameter is neither `payments` nor `transaction.settlement`.
* solution: Pass the `expand` query parameter value as either `payments` or `transaction.settlement`.
