# finalizeDispute

Mutation · GraphQL API

Finalizes a dispute and returns a payload that includes the dispute that was finalized. Only disputes with a status of OPEN can be finalized.

## Authentication

- SERVER

## Input

- `input` (`FinalizeDisputeInput!`) — required

## Returns [FinalizeDisputePayload](/braintree/graphql/reference/types/finalize-dispute-payload)

Top-level field returned when finalizing a dispute.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `dispute` (`Dispute`): Information about the dispute that was finalized.

## Examples

### Finalize dispute

Top-level input fields for finalizing a dispute.

```graphql
mutation finalizeDispute($input: FinalizeDisputeInput!) {
  finalizeDispute(input: $input) {
    clientMutationId
    dispute {
      __typename
      id
      legacyId
      amountDisputed {
        value
        currencyCode
      }
      amountWon {
        value
        currencyCode
      }
      caseNumber
      createdAt
      receivedDate
      referenceNumber
      responseDeadline
      replyByDate
      type
      evidence {
        __typename
        ... on DisputeFileEvidence {
          __typename
          id
          legacyId
          createdAt
          sentToProcessorAt
          url
          category
        }
        ... on DisputeTextEvidence {
          __typename
          id
          legacyId
          createdAt
          sentToProcessorAt
          content
          category
        }
      }
      originalDispute {
        __typename
        id
        legacyId
      }
      processorResponse {
        processorComments
        reason
        reasonCode
        reasonDescription
        receivedDate
        referenceNumber
      }
      status
      statusHistory {
        disbursementDate
        status
        timestamp
        effectiveDate
      }
      transaction {
        __typename
        id
        legacyId
      }
      protectionLevel
      preDisputeProgram
      remainingFileEvidenceStorage
    }
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)