disputes

Retrieve disputes based on query parameters

Operation

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
    }

}
}

Response

{
  "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

eq · Date

gt · Date

gte · Date

lt · 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

eq · Date

gt · Date

gte · Date

lt · Date

lte · Date

neq · Date

ngt · Date

ngte · Date

nlt · Date

nlte · Date

status · EnumFilterInputOfDisputeStatusInput

Show child attributes

eq · 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.

in · [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

eq · 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.

in · [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”.

id · 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”.

id · 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

id · 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.

id · 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

id · 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

Operation

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
    }

}
}

Response

{
  "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
      }
    }
  }
}