# Dispute

Object · GraphQL API

[A case raised by a customer to either request information about or to challenge a charge](https://articles.braintreepayments.com/risk-and-security/chargebacks-retrievals/overview). These are initiated via a customer's payment provider, such as their bank, and require a merchant to provide evidence or further information.

## Fields

- `id` (`ID!`) — non-null: Unique identifier.
- `legacyId` (`ID!`) — non-null: Legacy unique identifier.
- `amountDisputed` (`MonetaryAmount`): The amount of money from the original charge that the customer is disputing. Can be 0. This amount is debited from a merchant's account and held in a third-party account until the dispute is resolved, at which time it is sent to either the merchant or customer.
- `amountWon` (`MonetaryAmount`): If an amount was disputed, the amount of money awarded back to the merchant if the dispute was reversed.
- `caseNumber` (`String`): The case number for the dispute.
- `createdAt` (`Timestamp`): Date and time at which the dispute was created.
- `receivedDate` (`Date`): Date the dispute was received by the merchant.
- `referenceNumber` (`String`): The transaction reference number for the dispute.
- `responseDeadline` (`Timestamp`): The deadline for the merchant to submit a response to the dispute.
- `replyByDate` (`Date`): The reply by date for the merchant to submit a response to the dispute.
- `type` (`DisputeType`): The type of dispute.
- `evidence` (`[DisputeEvidence!]`): Evidence records submitted by the merchant for the dispute.
- `originalDispute` (`Dispute`): If this dispute is a follow-up to a previous chargeback or retrieval, the original dispute.
- `processorResponse` (`DisputeProcessorResponse`): Additional information from the payment processor.
- `status` (`DisputeStatus`): The status of the dispute.
- `statusHistory` (`[DisputeStatusEvent!]`): A log of history events containing status changes by date for this dispute.
- `transaction` (`Transaction`): The disputed transaction which the customer is either requesting further information on or challenging.
- `chargebackProtectionLevel` (`ChargebackProtectionLevel`) — deprecated since 2022-09-19: The chargeback protection status of the dispute.
- `protectionLevel` (`DisputeProtectionLevel`): The protection level of the dispute.
- `evidenceSubmittable` (`Boolean`) — deprecated since 2023-10-11: Indicates whether or not the merchant can upload evidence for this dispute based on its current status.
- `preDisputeProgram` (`PreDisputeProgram`): The pre-dispute program of the dispute.
- `remainingFileEvidenceStorage` (`Int`): The remaining storage available for file evidence on a dispute in bytes.

## Used by

- [AcceptDisputePayload](/braintree/graphql/reference/types/accept-dispute-payload) — Object; dispute
- [CreateDisputeFileEvidencePayload](/braintree/graphql/reference/types/create-dispute-file-evidence-payload) — Object; dispute
- [Dispute](/braintree/graphql/reference/types/dispute) — Object; originalDispute
- [DisputeConnectionEdge](/braintree/graphql/reference/types/dispute-connection-edge) — Object; node
- [FinalizeDisputePayload](/braintree/graphql/reference/types/finalize-dispute-payload) — Object; dispute
- [Node](/braintree/graphql/reference/types/node) — Interface; Possible type
- [Transaction](/braintree/graphql/reference/types/transaction) — Object; disputes

## GraphQL definition

```graphql
type Dispute implements Node {
  id: ID!
  legacyId: ID!
  amountDisputed: MonetaryAmount
  amountWon: MonetaryAmount
  caseNumber: String
  createdAt: Timestamp
  receivedDate: Date
  referenceNumber: String
  responseDeadline: Timestamp
  replyByDate: Date
  type: DisputeType
  evidence: [DisputeEvidence!]
  originalDispute: Dispute
  processorResponse: DisputeProcessorResponse
  status: DisputeStatus
  statusHistory: [DisputeStatusEvent!]
  transaction: Transaction
  chargebackProtectionLevel: ChargebackProtectionLevel @deprecated(reason: "Use `protectionLevel` instead.")
  protectionLevel: DisputeProtectionLevel
  evidenceSubmittable: Boolean @deprecated(reason: "This field is redundant to `OPEN` status which represents disputes with allowed evidence submission. For all other statuses it is not possible to submit evidence.")
  preDisputeProgram: PreDisputeProgram
  remainingFileEvidenceStorage: Int
}
```

---

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