---
title: "Get Dispute Reasons"
method: GET
path: "/v1/disputes/reasons"
tags: ["Disputes"]
---

# Get Dispute Reasons

`GET /v1/disputes/reasons`

## Request

- Base URL: `https://api.casaphq.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.casaphq.com/v1/disputes/reasons`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/casaphq/apis/casap-api/docs/v1/disputes/reasons/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the set of applicable parent-level dispute reason categories for the selected transactions. The member selects one of these categories; the specific sub-reason is determined downstream by the member's answers to the intake questionnaire. Call this after the Eligibility Check passes.

## Query parameters

- `transactionType` 'TRANSACTION_TYPE_UNKNOWN' | 'TRANSACTION_TYPE_DEBIT_CARD' | 'TRANSACTION_TYPE_CREDIT_CARD' | 'TRANSACTION_TYPE_ATM' | 'TRANSACTION_TYPE_ACH' | 'TRANSACTION_TYPE_TRANSFER' | 'TRANSACTION_TYPE_CREDIT_ATM' | 'TRANSACTION_TYPE_CREDIT_ACH' | 'TRANSACTION_TYPE_CREDIT_TRANSFER'

## Response `200`

A successful response.

- V1GetDisputeReasonsResponse: GetDisputeReasonsResponse lists the dispute reasons applicable to the requested transaction(s), each with default customer-facing display language.
  - `disputeReasons` DtoDisputeReasonOption[]
    - `reason` 'DISPUTE_REASON_UNKNOWN' | 'DISPUTE_REASON_UNAUTH' | 'DISPUTE_REASON_MERCHANT_ISSUE' | 'DISPUTE_REASON_ATM_ISSUE' | 'DISPUTE_REASON_ACH_ISSUE' | 'DISPUTE_REASON_TRANSFER_ISSUE' | 'DISPUTE_REASON_ATM_ISSUE_CASH_NOT_DISPENSED' | 'DISPUTE_REASON_MERCHANT_ISSUE_GOODS_OR_SERVICES_NOT_RECEIVED' | 'DISPUTE_REASON_MERCHANT_ISSUE_GOODS_OR_SERVICES_NOT_AS_DESCRIBED' | 'DISPUTE_REASON_MERCHANT_ISSUE_RETURNED' | 'DISPUTE_REASON_MERCHANT_ISSUE_CANCELED_SUBSCRIPTION' | 'DISPUTE_REASON_MERCHANT_ISSUE_REFUND_NOT_RECEIVED' | 'DISPUTE_REASON_MERCHANT_ISSUE_CHARGED_INCORRECT_AMOUNT' | 'DISPUTE_REASON_MERCHANT_ISSUE_PAID_BY_OTHER_MEANS' | 'DISPUTE_REASON_TRANSFER_ISSUE_NOT_RECEIVED' | 'DISPUTE_REASON_TRANSFER_ISSUE_INCORRECT_RECIPIENT' | 'DISPUTE_REASON_TRANSFER_ISSUE_INCORRECT_AMOUNT' | 'DISPUTE_REASON_TRANSFER_ISSUE_DUPLICATE_CHARGE' | 'DISPUTE_REASON_ATM_ISSUE_PARTIAL_CASH' | 'DISPUTE_REASON_MERCHANT_ISSUE_DUPLICATE_CHARGE' | 'DISPUTE_REASON_ATM_ISSUE_CASH_NOT_DEPOSITED' | 'DISPUTE_REASON_TRANSFER_ISSUE_FAILED_CANCELLATION' | 'DISPUTE_REASON_ACH_ISSUE_REVOKED' | 'DISPUTE_REASON_ACH_ISSUE_GOODS_OR_SERVICES' | 'DISPUTE_REASON_ACH_ISSUE_INCOMPLETE_TRANSACTION' | 'DISPUTE_REASON_ACH_ISSUE_IMPROPER_CHECK_PROCESSED' | 'DISPUTE_REASON_ACH_ISSUE_INCORRECT_AMOUNT' | 'DISPUTE_REASON_ACH_ISSUE_INCORRECT_DATE' | 'DISPUTE_REASON_ACH_ISSUE_DEBITED_MORE_THAN_ONCE' | 'DISPUTE_REASON_ACH_ISSUE_UNPROMPTED_DEBIT' | 'DISPUTE_REASON_ATM_ISSUE_DEPOSIT_NOT_POSTED' | 'DISPUTE_REASON_IN_STORE_CASH_NOT_DEPOSITED' | 'DISPUTE_REASON_CHECK_ISSUE' | 'DISPUTE_REASON_CHECK_ISSUE_FORGED_DRAWER' | 'DISPUTE_REASON_CHECK_ISSUE_ENDORSEMENT_FORGED' | 'DISPUTE_REASON_CHECK_ISSUE_PAYEE_NAME_ALTERED' | 'DISPUTE_REASON_CHECK_ISSUE_NOT_ENDORSED_BY_PAYEE' | 'DISPUTE_REASON_CHECK_ISSUE_ALTERED_AMOUNT' | 'DISPUTE_REASON_CHECK_ISSUE_COUNTERFEIT_CHECK' | 'DISPUTE_REASON_CHECK_ISSUE_UNAUTHORIZED_DRAFT' | 'DISPUTE_REASON_ACH_CREDIT_ISSUE' | 'DISPUTE_REASON_CREDIT_NOT_PROCESSED' | 'DISPUTE_REASON_CANCELLED_TRANSACTION' | 'DISPUTE_REASON_MERCHANDISE_RETURNED' | 'DISPUTE_REASON_MERCHANT_ISSUE_SERVICES_CANCELLED': DisputeReason is the dispute reason category. GetDisputeReasons returns the applicable parent categories; the specific sub-reason is resolved server-side from the questionnaire answers at Create time, so callers only ever submit a parent reason. Legacy reason values are normalized to this set before they reach the API, so these are the only values integrators see. - DISPUTE_REASON_ACH_ISSUE: Unauthorized ACH debit. Other ACH problems use the more specific DISPUTE_REASON_ACH_* values. - DISPUTE_REASON_ACH_CREDIT_ISSUE: Dispute about an ACH credit (incoming or outgoing credit entry), as opposed to the ACH_ISSUE_* family, which covers consumer debit disputes.
    - `displayMessage` string

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/casaphq/apis/casap-api.md) - [All operations](https://skmtc.dev/casaphq/apis/casap-api/llms.txt) - [OpenAPI document](https://skmtc.dev/casaphq/apis/casap-api/revisions/f159f2046015?raw)