disputes

query Disputes($input: DisputesQueryInput!) {
  disputes(input: $input) {
    items {
      acceptor {
        businessName
        id
        name
        reference
      }
      acquirer {
        businessName
        id
      }
      acquirerReferenceNumber
      amountContext
      assignment
      caseNumber
      createdDateTime
      disputeAmount
      disputeAttachments {
        createdDateTime
        description
        dispute
        fileName
        fileType
        fileUrl
        id
      }
      disputeCurrencyCode
      disputeDate
      disputeEvents {

      }
      disputeFundingAmount
      disputeFundingCurrency
      id
      lastUpdatedUserId
      lifeCycle
      networkReason
      networkReasonCode
      networkReasonLabel
      organization {
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      processingNetwork
      processorExpirationDate
      respondByDate
      status
      transactionId
      updatedDateTime
      workflowAssignment
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }

}
}

{
  "data": {
    "disputes": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "acquirer": {
            "acquirerBin": [
              "example"
            ],
            "businessName": "Clacksworth Keyboards",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          },
          "acquirerReferenceNumber": "example",
          "amountContext": "FULL_AMOUNT",
          "assignment": "CARD_NETWORK",
          "caseNumber": "example",
          "createdDateTime": "2026-01-15T14:30:00Z",
          "disputeAmount": 0,
          "disputeAttachments": [
            {
              "acceptor": "example",
              "acquirer": "example",
              "createdDateTime": "2026-01-15T14:30:00Z",
              "description": "example",
              "dispute": "example",
              "fileName": "business-license.pdf",
              "fileType": "BMP",
              "fileUrl": "example",
              "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
              "organization": "example"
            }
          ],
          "disputeCurrencyCode": "USD",
          "disputeDate": "2026-01-15",
          "disputeEvents": {
            "items": [
              "example"
            ],
            "pageInfo": "example"
          },
          "disputeFundingAmount": 0,
          "disputeFundingCurrency": "USD",
          "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "lastUpdatedUserId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "lifeCycle": "ARBITRATION",
          "networkReason": "NONE",
          "networkReasonCode": "example",
          "networkReasonLabel": "example",
          "organization": {
            "acceptorApplicationCounts": [
              "example"
            ],
            "acceptors": "example",
            "achNotificationsOfChange": "example",
            "achReturns": "example",
            "allocations": "example",
            "allowedMerchantCategories": [
              "example"
            ],
            "authorizationSummaries": "example",
            "businessAddress": "example",
            "businessName": "Clacksworth Keyboards",
            "capabilities": [
              "ACQUIRING"
            ],
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisbursementReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "legalName": "example",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "phoneNumber": "example",
            "reportAvailability": [
              "example"
            ],
            "settings": "example"
          },
          "paymentBrand": "VISA",
          "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "processingNetwork": "VISA",
          "processorExpirationDate": "2026-01-15",
          "respondByDate": "2026-01-15",
          "status": "OPEN",
          "transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "updatedDateTime": "2026-01-15T14:30:00Z",
          "workflowAssignment": "CARD_NETWORK"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}

query Disputes($input: DisputesQueryInput!) {
  disputes(input: $input) {
    items {
      acceptor {
        businessName
        id
        name
        reference
      }
      acquirer {
        businessName
        id
      }
      acquirerReferenceNumber
      amountContext
      assignment
      caseNumber
      createdDateTime
      disputeAmount
      disputeAttachments {
        createdDateTime
        description
        dispute
        fileName
        fileType
        fileUrl
        id
      }
      disputeCurrencyCode
      disputeDate
      disputeEvents {

      }
      disputeFundingAmount
      disputeFundingCurrency
      id
      lastUpdatedUserId
      lifeCycle
      networkReason
      networkReasonCode
      networkReasonLabel
      organization {
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      processingNetwork
      processorExpirationDate
      respondByDate
      status
      transactionId
      updatedDateTime
      workflowAssignment
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }

}
}

{
  "data": {
    "disputes": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "acquirer": {
            "acquirerBin": [
              "example"
            ],
            "businessName": "Clacksworth Keyboards",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          },
          "acquirerReferenceNumber": "example",
          "amountContext": "FULL_AMOUNT",
          "assignment": "CARD_NETWORK",
          "caseNumber": "example",
          "createdDateTime": "2026-01-15T14:30:00Z",
          "disputeAmount": 0,
          "disputeAttachments": [
            {
              "acceptor": "example",
              "acquirer": "example",
              "createdDateTime": "2026-01-15T14:30:00Z",
              "description": "example",
              "dispute": "example",
              "fileName": "business-license.pdf",
              "fileType": "BMP",
              "fileUrl": "example",
              "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
              "organization": "example"
            }
          ],
          "disputeCurrencyCode": "USD",
          "disputeDate": "2026-01-15",
          "disputeEvents": {
            "items": [
              "example"
            ],
            "pageInfo": "example"
          },
          "disputeFundingAmount": 0,
          "disputeFundingCurrency": "USD",
          "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "lastUpdatedUserId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "lifeCycle": "ARBITRATION",
          "networkReason": "NONE",
          "networkReasonCode": "example",
          "networkReasonLabel": "example",
          "organization": {
            "acceptorApplicationCounts": [
              "example"
            ],
            "acceptors": "example",
            "achNotificationsOfChange": "example",
            "achReturns": "example",
            "allocations": "example",
            "allowedMerchantCategories": [
              "example"
            ],
            "authorizationSummaries": "example",
            "businessAddress": "example",
            "businessName": "Clacksworth Keyboards",
            "capabilities": [
              "ACQUIRING"
            ],
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisbursementReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "legalName": "example",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "phoneNumber": "example",
            "reportAvailability": [
              "example"
            ],
            "settings": "example"
          },
          "paymentBrand": "VISA",
          "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "processingNetwork": "VISA",
          "processorExpirationDate": "2026-01-15",
          "respondByDate": "2026-01-15",
          "status": "OPEN",
          "transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "updatedDateTime": "2026-01-15T14:30:00Z",
          "workflowAssignment": "CARD_NETWORK"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}

Query

Arguments

input

DisputesQueryInput!

required

Show child attributes

orderBy

[DisputesSortTypeInput!]

Show child attributes

field

DisputesSortField!

required

Show Possible enum values

DISPUTE_DATE

enum

Sort by the date on which the dispute was reported.

RESPOND_BY_DATE

enum

Sort by the date by which the current dispute lifecycle must be responded to.

sortDirection

SortingEnumType!

required

See SortingEnumType

paging

PagingInput!

required

See PagingInput

where

DisputesFilterInput!

required

Show child attributes

acceptorId

GuidFilterInput

See GuidFilterInput

caseNumber

StringFilterInput

See StringFilterInput

disputeDate

DateFilterInput

Show child attributes

Date

gte

Date

lte

Date

neq

Date

ngt

Date

ngte

Date

nlt

Date

nlte

Date

disputeId

GuidFilterInput

See GuidFilterInput

organizationId

GuidFilterInput

See GuidFilterInput

paymentBrand

EnumFilterInputOfPaymentBrandInput

See EnumFilterInputOfPaymentBrandInput

processorExpirationDate

DateFilterInput

Show child attributes

Date

gte

Date

lte

Date

neq

Date

ngt

Date

ngte

Date

nlt

Date

nlte

Date

status

EnumFilterInputOfDisputeStatusInput

Show child attributes

DisputeStatus

Show Possible enum values

OPEN

enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED

enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

[DisputeStatus!]

Show Possible enum values

OPEN

enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED

enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

nin

[DisputeStatus!]

Show Possible enum values

OPEN

enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED

enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

workflowAssignment

EnumFilterInputOfDisputeWorkflowAssignmentInput

Show child attributes

DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

[DisputeWorkflowAssignment!]

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

nin

[DisputeWorkflowAssignment!]

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

Return type

DisputeCollection

items

[Dispute!]!

required

Show child attributes

acceptor

Acceptor

See Acceptor

acquirer

Acquirer

Show child attributes

acquirerBin

[AcquirerBin!]!

required

Show child attributes

bin

String

paymentNetwork

Network

See Network

businessName

String!

required

The descriptive name for the acquirer that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.

UUID!

required

The id of the acquirer as defined in their profile.

acquirerReferenceNumber

String

amountContext

DisputeAmountContext

Show Possible enum values

FULL_AMOUNT

enum

The full amount of the original transaction is being disputed.

PARTIAL_AMOUNT

enum

Only a part of the original transaction amount is being disputed.

assignment

DisputeWorkflowAssignment

deprecated

Deprecated: Use workflowAssignment instead.

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

caseNumber

String

createdDateTime

DateTime

disputeAmount

Decimal

disputeAttachments

[DisputeAttachment!]

Show child attributes

acceptor

Acceptor

See Acceptor

acquirer

Acquirer

Show child attributes

acquirerBin

[AcquirerBin!]!

required

businessName

String!

required

The descriptive name for the acquirer that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.

UUID!

required

The id of the acquirer as defined in their profile.

createdDateTime

DateTime

description

String

dispute

Dispute

fileName

String

fileType

FileType

Show Possible enum values

BMP

enum

GIF

enum

JPEG

enum

JPG

enum

PDF

enum

PNG

enum

TIF

enum

TIFF

enum

UNKNOWN

enum

fileUrl

String

UUID

organization

Organization

See Organization

disputeCurrencyCode

CurrencyCodeAlpha

disputeDate

Date

disputeEvents

DisputeEventCollection

Show child attributes

items

[DisputeEvent!]!

required

Show child attributes

acceptor

Acceptor

acquirer

Acquirer

attachment

DisputeAttachment

createdDateTime

DateTime

cycle

DisputeLifeCycle

deprecated

Deprecated: Use lifeCycle instead.See DisputeLifeCycle

dateOfEvent

Date

dispute

Dispute

eventType

DisputeEventType

Show Possible enum values

ARBITRATION_APPEALED

enum

ARBITRATION_RAISED

enum

CASE_CLOSED

enum

DECISION_RULED_IN_FAVOR_OF_ACCEPTOR

enum

DECISION_RULED_IN_FAVOR_OF_ISSUER

enum

…and 13 more values. See DisputeEventType for the full list.

fromQueue

DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

UUID

lifeCycle

DisputeLifeCycle

See DisputeLifeCycle

organization

Organization

source

DisputeEventSource

Show Possible enum values

API

enum

NETWORK

enum

SYSTEM

enum

USER

enum

status

DisputeStatus

Show Possible enum values

OPEN

enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED

enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

toQueue

DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

userId

UUID

pageInfo

PageInfo!

required

See PageInfo

disputeFundingAmount

Decimal

disputeFundingCurrency

CurrencyCodeAlpha

UUID

lastUpdatedUserId

UUID

lifeCycle

DisputeLifeCycle

See DisputeLifeCycle

networkReason

NetworkReason

Show Possible enum values

NONE

enum

VISA_EMV_LIABILITY_SHIFT_COUNTERFEIT_FRAUD

enum

VISA_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT_FRAUD

enum

VISA_OTHER_FRAUD_CARD_PRESENT_ENVIRONMENT

enum

VISA_OTHER_FRAUD_CARD_ABSENT_ENVIRONMENT

enum

…and 113 more values. See NetworkReason for the full list.

networkReasonCode

String

networkReasonLabel

String

organization

Organization

See Organization

paymentBrand

PaymentBrand

See PaymentBrand

paymentId

UUID

A unique 36 character identifier created by Tesouro and assigned to a group of transactions in the same payment request cohort. e.g., An authorization request, incremental authorization request, and the final capture would have the same paymentID.

processingNetwork

Network

See Network

processorExpirationDate

Date

respondByDate

Date

status

DisputeStatus

Show Possible enum values

OPEN

enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED

enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

transactionId

UUID

deprecated

Deprecated: Will be removed in a future release.

updatedDateTime

DateTime

workflowAssignment

DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK

enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER

enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR

enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

pageInfo

PageInfo!

required

Show child attributes

hasNextPage

Boolean!

required

hasPreviousPage

Boolean!

required

query Disputes($input: DisputesQueryInput!) {
  disputes(input: $input) {
    items {
      acceptor {
        businessName
        id
        name
        reference
      }
      acquirer {
        businessName
        id
      }
      acquirerReferenceNumber
      amountContext
      assignment
      caseNumber
      createdDateTime
      disputeAmount
      disputeAttachments {
        createdDateTime
        description
        dispute
        fileName
        fileType
        fileUrl
        id
      }
      disputeCurrencyCode
      disputeDate
      disputeEvents {

      }
      disputeFundingAmount
      disputeFundingCurrency
      id
      lastUpdatedUserId
      lifeCycle
      networkReason
      networkReasonCode
      networkReasonLabel
      organization {
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      processingNetwork
      processorExpirationDate
      respondByDate
      status
      transactionId
      updatedDateTime
      workflowAssignment
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }

}
}

{
  "data": {
    "disputes": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "acquirer": {
            "acquirerBin": [
              "example"
            ],
            "businessName": "Clacksworth Keyboards",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          },
          "acquirerReferenceNumber": "example",
          "amountContext": "FULL_AMOUNT",
          "assignment": "CARD_NETWORK",
          "caseNumber": "example",
          "createdDateTime": "2026-01-15T14:30:00Z",
          "disputeAmount": 0,
          "disputeAttachments": [
            {
              "acceptor": "example",
              "acquirer": "example",
              "createdDateTime": "2026-01-15T14:30:00Z",
              "description": "example",
              "dispute": "example",
              "fileName": "business-license.pdf",
              "fileType": "BMP",
              "fileUrl": "example",
              "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
              "organization": "example"
            }
          ],
          "disputeCurrencyCode": "USD",
          "disputeDate": "2026-01-15",
          "disputeEvents": {
            "items": [
              "example"
            ],
            "pageInfo": "example"
          },
          "disputeFundingAmount": 0,
          "disputeFundingCurrency": "USD",
          "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "lastUpdatedUserId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "lifeCycle": "ARBITRATION",
          "networkReason": "NONE",
          "networkReasonCode": "example",
          "networkReasonLabel": "example",
          "organization": {
            "acceptorApplicationCounts": [
              "example"
            ],
            "acceptors": "example",
            "achNotificationsOfChange": "example",
            "achReturns": "example",
            "allocations": "example",
            "allowedMerchantCategories": [
              "example"
            ],
            "authorizationSummaries": "example",
            "businessAddress": "example",
            "businessName": "Clacksworth Keyboards",
            "capabilities": [
              "ACQUIRING"
            ],
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisbursementReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "legalName": "example",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "phoneNumber": "example",
            "reportAvailability": [
              "example"
            ],
            "settings": "example"
          },
          "paymentBrand": "VISA",
          "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "processingNetwork": "VISA",
          "processorExpirationDate": "2026-01-15",
          "respondByDate": "2026-01-15",
          "status": "OPEN",
          "transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "updatedDateTime": "2026-01-15T14:30:00Z",
          "workflowAssignment": "CARD_NETWORK"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}

Verify account Respond to dispute

⌘I

Boarding

Transaction Processing

Risk, Compliance & Dispute Management

Reporting

Types

Arguments

Return type

Boarding

Transaction Processing

Risk, Compliance & Dispute Management

Reporting

Types

​Arguments

​Return type

Arguments

Return type