query FundingDisputeEvents($input: FundingDisputeEventInput!) {
fundingDisputeEvents(input: $input) {
items {
acceptor {
businessName
fundingDisputeEvents
id
name
reference
}
acquirerReferenceNumber
caseNumber
dateOfEvent
disputeId
fundingAmount
fundingCurrency
fundsReleaseDate
fundsTransferDescriptor
fundsTransferId
id
lifeCycle
organization {
businessName
capabilities
fundingDisputeEvents
id
legalName
name
phoneNumber
}
paymentBrand
paymentId
perspective
processingNetwork
transactionId
transactionReference
}
pageInfo {
hasNextPage
hasPreviousPage
}
}
}
{
"input": {
"paging": {
"skip": 0,
"take": 0
},
"where": {
"acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"dateOfEvent": "example",
"fundsReleaseDate": "example"
}
}
}
curl --request POST \
--url https://api.sandbox.com/graphql \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
"query": "query FundingDisputeEvents($input: FundingDisputeEventInput!) {\n fundingDisputeEvents(input: $input) {\n items {\n acceptor {\n businessName\n fundingDisputeEvents\n id\n name\n reference\n }\n acquirerReferenceNumber\n caseNumber\n dateOfEvent\n disputeId\n fundingAmount\n fundingCurrency\n fundsReleaseDate\n fundsTransferDescriptor\n fundsTransferId\n id\n lifeCycle\n organization {\n businessName\n capabilities\n fundingDisputeEvents\n id\n legalName\n name\n phoneNumber\n }\n paymentBrand\n paymentId\n perspective\n processingNetwork\n transactionId\n transactionReference\n }\n pageInfo {\n hasNextPage\n hasPreviousPage\n }\n }\n}",
"variables": {
"input": {
"paging": {
"skip": 0,
"take": 0
},
"where": {
"acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"dateOfEvent": "example",
"fundsReleaseDate": "example"
}
}
}
}'
{
"data": {
"fundingDisputeEvents": {
"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"
},
"acquirerReferenceNumber": "example",
"caseNumber": "example",
"dateOfEvent": "2026-01-15",
"disputeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"fundingAmount": 0,
"fundingCurrency": "example",
"fundsReleaseDate": "2026-01-15",
"fundsTransferDescriptor": "example",
"fundsTransferId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"lifeCycle": "ARBITRATION",
"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": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
"legalName": "example",
"name": "Ben Torres",
"paymentTransactions": "example",
"paymentTransactionSummaries": "example",
"phoneNumber": "example",
"reportAvailability": [
"example"
],
"settings": "example"
},
"paymentBrand": "VISA",
"paymentId": "b6d4e5f6-7a8b-9012-3def-456789012345",
"perspective": "PARTNER",
"processingNetwork": "example",
"transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"transactionReference": "example"
}
],
"pageInfo": {
"hasNextPage": true,
"hasPreviousPage": true
}
}
}
}
Reporting
fundingDisputeEvents
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
query FundingDisputeEvents($input: FundingDisputeEventInput!) {
fundingDisputeEvents(input: $input) {
items {
acceptor {
businessName
fundingDisputeEvents
id
name
reference
}
acquirerReferenceNumber
caseNumber
dateOfEvent
disputeId
fundingAmount
fundingCurrency
fundsReleaseDate
fundsTransferDescriptor
fundsTransferId
id
lifeCycle
organization {
businessName
capabilities
fundingDisputeEvents
id
legalName
name
phoneNumber
}
paymentBrand
paymentId
perspective
processingNetwork
transactionId
transactionReference
}
pageInfo {
hasNextPage
hasPreviousPage
}
}
}
{
"input": {
"paging": {
"skip": 0,
"take": 0
},
"where": {
"acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"dateOfEvent": "example",
"fundsReleaseDate": "example"
}
}
}
curl --request POST \
--url https://api.sandbox.com/graphql \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
"query": "query FundingDisputeEvents($input: FundingDisputeEventInput!) {\n fundingDisputeEvents(input: $input) {\n items {\n acceptor {\n businessName\n fundingDisputeEvents\n id\n name\n reference\n }\n acquirerReferenceNumber\n caseNumber\n dateOfEvent\n disputeId\n fundingAmount\n fundingCurrency\n fundsReleaseDate\n fundsTransferDescriptor\n fundsTransferId\n id\n lifeCycle\n organization {\n businessName\n capabilities\n fundingDisputeEvents\n id\n legalName\n name\n phoneNumber\n }\n paymentBrand\n paymentId\n perspective\n processingNetwork\n transactionId\n transactionReference\n }\n pageInfo {\n hasNextPage\n hasPreviousPage\n }\n }\n}",
"variables": {
"input": {
"paging": {
"skip": 0,
"take": 0
},
"where": {
"acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"dateOfEvent": "example",
"fundsReleaseDate": "example"
}
}
}
}'
{
"data": {
"fundingDisputeEvents": {
"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"
},
"acquirerReferenceNumber": "example",
"caseNumber": "example",
"dateOfEvent": "2026-01-15",
"disputeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"fundingAmount": 0,
"fundingCurrency": "example",
"fundsReleaseDate": "2026-01-15",
"fundsTransferDescriptor": "example",
"fundsTransferId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"lifeCycle": "ARBITRATION",
"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": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
"legalName": "example",
"name": "Ben Torres",
"paymentTransactions": "example",
"paymentTransactionSummaries": "example",
"phoneNumber": "example",
"reportAvailability": [
"example"
],
"settings": "example"
},
"paymentBrand": "VISA",
"paymentId": "b6d4e5f6-7a8b-9012-3def-456789012345",
"perspective": "PARTNER",
"processingNetwork": "example",
"transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"transactionReference": "example"
}
],
"pageInfo": {
"hasNextPage": true,
"hasPreviousPage": true
}
}
}
}
Query
Arguments
FundingDisputeEventInput!
required
Show child attributes
Show child attributes
PagingInput!
required
See PagingInput
FundingDisputeEventsFilterInput!
required
Show child attributes
Show child attributes
GuidFilterInput
See GuidFilterInput
DateRangeFilterInput
DateRangeFilterInput
GuidFilterInput
See GuidFilterInput
EnumFilterInputOfPaymentBrandInput
EnumFilterInputOfPerspectiveInput
Return type
FundingDisputeEventOutputCollection
[FundingDisputeEventOutput!]!
required
Show child attributes
Show child attributes
String!
required
The Acquirer Reference Number (ARN) is a unique 23 digit number created by Tesouro, that was assigned to the original transaction and provided to the acquiring and issuing banks for their purpose of tracing the transaction through the full process until it is funded to the bank.
String
The case number assigned to the dispute.
Date
The date the dispute lifecycle was received.
UUID!
required
A unique identifier created and used internally by Tesouro, and assigned to the dispute.
Decimal
The funded amount of the dispute, which may be different from the “dispute amount” if the original transaction’s amount was presented in a different currency than its funding currency.
String
The currency associated with the dispute funding amount
Date
The date the debited or credited funds for the dispute lifecycle were released.
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account for this dispute, that identifies a cohort of funded transactions making up the transfer.
UUID!
required
A unique identifier created by Tesouro and assigned to the dispute event resulting in the credit or debit.
DisputeLifeCycle!
required
Specifies where in the life cycle the dispute is at, e.g., Retrieval request, Chargeback, Representment, Pre-arbitration, etc.See DisputeLifeCycle
Organization!
required
See Organization
PaymentBrand
The brand of payment method used.See PaymentBrand
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.
Perspective
The perspective of the dispute, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the dispute is reported.See Perspective
String
The processing network that the transaction was sent across, which may be unaffiliated with the card brand.
UUID!
required
A unique identifier assigned by Tesouro for the transaction associated with this dispute event.
String
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
query FundingDisputeEvents($input: FundingDisputeEventInput!) {
fundingDisputeEvents(input: $input) {
items {
acceptor {
businessName
fundingDisputeEvents
id
name
reference
}
acquirerReferenceNumber
caseNumber
dateOfEvent
disputeId
fundingAmount
fundingCurrency
fundsReleaseDate
fundsTransferDescriptor
fundsTransferId
id
lifeCycle
organization {
businessName
capabilities
fundingDisputeEvents
id
legalName
name
phoneNumber
}
paymentBrand
paymentId
perspective
processingNetwork
transactionId
transactionReference
}
pageInfo {
hasNextPage
hasPreviousPage
}
}
}
{
"input": {
"paging": {
"skip": 0,
"take": 0
},
"where": {
"acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"dateOfEvent": "example",
"fundsReleaseDate": "example"
}
}
}
curl --request POST \
--url https://api.sandbox.com/graphql \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
"query": "query FundingDisputeEvents($input: FundingDisputeEventInput!) {\n fundingDisputeEvents(input: $input) {\n items {\n acceptor {\n businessName\n fundingDisputeEvents\n id\n name\n reference\n }\n acquirerReferenceNumber\n caseNumber\n dateOfEvent\n disputeId\n fundingAmount\n fundingCurrency\n fundsReleaseDate\n fundsTransferDescriptor\n fundsTransferId\n id\n lifeCycle\n organization {\n businessName\n capabilities\n fundingDisputeEvents\n id\n legalName\n name\n phoneNumber\n }\n paymentBrand\n paymentId\n perspective\n processingNetwork\n transactionId\n transactionReference\n }\n pageInfo {\n hasNextPage\n hasPreviousPage\n }\n }\n}",
"variables": {
"input": {
"paging": {
"skip": 0,
"take": 0
},
"where": {
"acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"dateOfEvent": "example",
"fundsReleaseDate": "example"
}
}
}
}'
{
"data": {
"fundingDisputeEvents": {
"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"
},
"acquirerReferenceNumber": "example",
"caseNumber": "example",
"dateOfEvent": "2026-01-15",
"disputeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"fundingAmount": 0,
"fundingCurrency": "example",
"fundsReleaseDate": "2026-01-15",
"fundsTransferDescriptor": "example",
"fundsTransferId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"lifeCycle": "ARBITRATION",
"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": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
"legalName": "example",
"name": "Ben Torres",
"paymentTransactions": "example",
"paymentTransactionSummaries": "example",
"phoneNumber": "example",
"reportAvailability": [
"example"
],
"settings": "example"
},
"paymentBrand": "VISA",
"paymentId": "b6d4e5f6-7a8b-9012-3def-456789012345",
"perspective": "PARTNER",
"processingNetwork": "example",
"transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"transactionReference": "example"
}
],
"pageInfo": {
"hasNextPage": true,
"hasPreviousPage": true
}
}
}
}
Was this page helpful?