---
title: "Update dispute status"
method: POST
path: "/v1/customer/disputes/{id}/require-evidence"
tags: ["disputes-actions"]
---

# Update dispute status

`POST /v1/customer/disputes/{id}/require-evidence`

## Request

- Base URL: `https://api-m.paypal.com`
- URL: `https://api-m.paypal.com/v1/customer/disputes/{id}/require-evidence`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `/v1/oauth2/token` scopes: `https://uri.paypal.com/services/disputes/update-seller`
  - OAuth 2
    - Client credentials
    - Token URL: `/v1/oauth2/token` scopes: `https://uri.paypal.com/services/disputes/update-buyer`
- TypeScript: <https://skmtc.dev/paypal/apis/payments/docs/v1/customer/disputes/:id/require-evidence/post.ts> (a function with typed inputs; its response is checked against the schema)

<blockquote><strong>Important:</strong> This method is for sandbox use only.</blockquote> Updates the status of a dispute, by ID, from <code>UNDER_REVIEW</code> to either:<ul><li><code>WAITING_FOR_BUYER_RESPONSE</code></li><li><code>WAITING_FOR_SELLER_RESPONSE</code></li></ul>This status change enables either the customer or merchant to submit evidence for the dispute. To make this call, the dispute <code>status</code> must be <code>UNDER_REVIEW</code> and <code>require-evidence</code> link  should be available in the <a href="/docs/api/customer-disputes/v1/#disputes_get!c=200&path=links&t=response/">HATEOAS links</a> of the <a href="/docs/api/customer-disputes/v1/#disputes_get">show dispute details</a> response. Specify an <code>action</code> value in the JSON request body to indicate whether the status change enables the customer or merchant to submit evidence:<table><thead><tr align="left"><th>If <code>action</code> is</th><th>The <code>status</code> updates to</th></tr></thead><tbody><tr><td><code>BUYER_EVIDENCE</code></td><td> <code>WAITING_FOR_BUYER_RESPONSE</code></td></tr><tr><td><code>SELLER_EVIDENCE</code></td><td> <code>WAITING_FOR_SELLER_RESPONSE</code></td></tr></tbody></table>.

## Path parameters

- `id` string, required

## Request body

- RequireEvidence: Sandbox only. Updates the state of a dispute, by ID, to either <code>WAITING_FOR_BUYER_RESPONSE</code> or <code>WAITING_FOR_SELLER_RESPONSE</code>. This state change enables either the customer or merchant to submit evidence for the dispute. Specify an <code>action</code> value in the JSON request body to indicate whether the state change enables the customer or merchant to submit evidence.
  - `action` 'BUYER_EVIDENCE' | 'SELLER_EVIDENCE', required: The action. Indicates whether the state change enables the customer or merchant to submit evidence.

## Response `200`

A successful request returns the HTTP `200 OK` status code and a JSON response body that includes a link to the dispute.

- SubsequentAction: The subsequent action.
  - `links` LinkDescription[]: An array of request-related [HATEOAS links](/docs/api/reference/api-responses/#hateoas-links/).
    - `href` string, required: The complete target URL. To make the related call, combine the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570) link. For pre-processing, include the `$`, `(`, and `)` characters. The `href` is the key HATEOAS component that links a completed call with a subsequent call.
    - `rel` string, required: The [link relation type](https://tools.ietf.org/html/rfc5988#section-4), which serves as an ID for a link that unambiguously describes the semantics of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml).
    - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' | 'CONNECT' | 'OPTIONS' | 'PATCH': The HTTP method required to make the related call.

## Other responses

- `400`: The request failed due to a validation error. The request returns the HTTP `400 Bad Request` status code.
- `422`: The requested action could not be completed. The request returns the HTTP `422 Unprocessable Entity` status code.
- `500`: An internal server error occurred. The request returns the HTTP `500 Internal Server Error` status code.
- `default`: The error response.

---

[API](https://skmtc.dev/paypal/apis/payments.md) - [All operations](https://skmtc.dev/paypal/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/paypal/apis/payments/revisions/672aceee1190?raw)