Skip to main content
GET
/
disputes
List disputes
curl --request GET \
  --url https://api.synctera.com/v2/disputes
{
  "disputes": [
    {
      "account_id": "ca4450a5-5d4c-4afc-9533-729e2948c477",
      "applicable_regulation": "REGULATION_E",
      "creation_time": "2010-05-06T12:23:34.321Z",
      "currency": "USD",
      "customer_id": "52593ea7-4d66-40df-80e9-3b9bc54fa880",
      "date_customer_reported": "2010-05-06T12:23:34.321Z",
      "decision": "LOST",
      "dispute_documents": [
        {
          "creation_time": "2010-05-06T12:23:34.321Z",
          "dispute_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
          "file_name": "example.pdf",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "tenant": "abcdef_ghijkl"
        }
      ],
      "disputed_amount": 2,
      "external_reference_id": "<string>",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "last_action_by": "NETWORK",
      "last_updated_time": "2010-05-06T12:23:34.321Z",
      "memo": "<string>",
      "network": "NONE",
      "payment_rail": "CARD",
      "status": "OPEN",
      "tenant": "abcdef_ghijkl",
      "timestamp_final_decision": "2023-11-07T05:31:56Z",
      "timestamp_investigation_due": "2023-11-07T05:31:56Z",
      "timestamp_provisional_credit_due": "2023-11-07T05:31:56Z",
      "transaction_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "action_history": [
        {
          "action": "CHARGEBACK",
          "creation_time": "2010-05-06T12:23:34.321Z",
          "external_reference_id": "<string>",
          "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
          "memo": "<string>",
          "message": "<string>",
          "payment_rail": "CARD",
          "reason_code": "ATM_CASH_DISPUTE",
          "representment_reason_code": "INVALID_ACQUIRER_REFERENCE_DATA",
          "status": "ACCEPTED",
          "supporting_doc_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
          "tenant": "abcdef_ghijkl",
          "updated_reason_code_memo": "<string>",
          "violation_code": "INACCURATE_AUTH",
          "violation_date": "2023-11-07T05:31:56Z"
        }
      ],
      "available_actions": [
        {
          "action": "CHARGEBACK",
          "state": "ACCEPT",
          "timestamp_valid_to": "2010-05-06T12:23:34.321Z"
        }
      ],
      "credit_status": "NONE",
      "lifecycle_state": "DENIED",
      "managed_by": "CUSTOMER",
      "network_eligibility": {
        "is_digital_wallet_token": true,
        "is_network_eligibility_overridden": true,
        "is_three_ds": true
      },
      "reason_code": "ATM_CASH_DISPUTE"
    }
  ],
  "next_page_token": "a8937a0d"
}

Query Parameters

​
end_time
string<date-time>

Only display disputes with a final decision time less than or equal to end_time

​
start_time
string<date-time>

Only display disputes with a creation time greater than or equal to start_time

​
to_date
string<date>

Only display disputes with a creation date less than or equal to to_date

​
from_date
string<date>

Only display disputes with a creation date greater than or equal to from_date

​
status
enum<string>

The current status of the dispute.

Available options:
OPEN,
CLOSED
​
account_id
string<uuid>

uuid representing an account

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
decision
enum<string>
DecisionDescription
LOSTDecision reached in favour of the network.
NONENo decision was reached.
ONGOINGDispute is ongoing and requires further action.
RESOLVEDResolved in favour of the account holder.
WONDecision reached in favour of the account holder.
Available options:
LOST,
NONE,
ONGOING,
RESOLVED,
WON
​
transaction_id
string<uuid>

The unique identifier of a posted transaction

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
related_transaction_id
string<uuid>

The unique identifier for a transaction related to the dispute, such as a provisional credit or chargeback.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
payment_rail
enum<string>

Specifies the payment rail type for the returned disputes.

Available options:
CARD,
EXTERNAL_CARD,
ACH
​
limit
integer
default:100

Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.

Required range: x >= 1
Example:

100

​
page_token
string

Optional pagination token to be provided to retrieve subsequent pages, returned from previous get

Example:

"a8937a0d"

Response

List of disputes

​
disputes
(Card Dispute · object | External Card · object | ACH Dispute · object)[]
required

Array of disputes

  • Card Dispute
  • External Card
  • ACH Dispute
​
next_page_token
string

If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

Example:

"a8937a0d"