--- title: "Fetch Disputes" method: GET path: "/api/v2/disputes" tags: ["Disputes"] --- # Fetch Disputes `GET /api/v2/disputes` ## Request - Base URL: `https://api.chargeblast.com` - URL: `https://api.chargeblast.com/api/v2/disputes` - Auth: none declared. Required headers: `X-API-Key` Get all the chargeback disputes from your Chargeblast account. Each dispute includes linked alert, deflection, and evidence-submission data where available — roughly matching what the Chargeblast dashboard shows for a dispute. ## Query parameters - `status` 'needs_response' | 'under_review' | 'charge_refunded' | 'won' | 'lost' | 'protected' | 'prevented', nullable - `startDate` string, nullable - `endDate` string, nullable - `managedByChargeblast` boolean, nullable - `page` integer, nullable - `per` integer, nullable ## Headers - `X-API-Key` string, required ## Response `200` OK - APIDisputesResponse - `disputes` APIDisputeDetail[], required: The disputes for this page. - `dispute` CommonDisputeDirectDTO, required - `id` string, nullable: Chargeblast dispute id. - `transactionDate` string, date-time, required: Date and time of the original charge. - `disputeDate` string, date-time, required: Date and time the dispute was opened. - `submittedEvidence` boolean, nullable: Whether evidence has already been submitted for this dispute. - `amount` number, double, required: Disputed transaction amount, in cents. For example, $19.99 is 1999. - `currency` string, nullable: ISO currency code of the original charge (e.g. USD). - `customer` string, nullable - `refunded` boolean, nullable - `descriptor` string, nullable: Billing descriptor shown on the card statement. - `status` 'succeeded' | 'failed' | 'pending' - `last4` string, nullable - `shop` string, nullable - `bin` string, nullable - `wallet` 'apple_pay' | 'paypal' | 'google_pay' | 'link' | '' | 'Bank' | 'cash_app' | 'pulse' | 'star' | 'nyce' | 'accel' | 'shazam' | 'pix' | 'klarna' | 'affirm' | 'afterpay_clearpay' | 'zip' | 'amazon_pay' | 'sepa_debit' | 'sunbit' - `source` 'Stripe' | 'Shopify' | 'CheckoutChamp' | 'Braintree' | 'Mamopay' | 'Maverick' | 'Sticky' | 'Unknown' | 'API' | '29Next' | 'Square' | 'Spreedly' | 'Airwallex' | 'NMI' | 'Auth' | 'Primer' | 'Payarc' | 'PaymentKit' | 'Chargebee' | 'Phoenix' | 'Adyen' | 'Recurly' | 'Gr4vy' | 'Recharge' | 'Openpay' | 'Finix' | 'Worldpay' | 'FMJ' | 'Coinflow' | 'Xecom' | 'Vrio' | 'Checkout' | 'a55' | 'Seal' | 'GuestyPay' | 'Fyntek' | 'Paytech' | 'SwissCRM' | 'Paysight' | 'Whop' | 'Spark' | 'Kurv' | 'Everflow' | 'IMerchant' | 'RocketGate', required: • Stripe → Stripe • Shopify → Shopify • CheckoutChamp → CheckoutChamp • Braintree → Braintree • Mamopay → Mamopay • Maverick → Maverick • Sticky → Sticky • Unknown → Unknown • API → API • 29Next → Next • Square → Square • Spreedly → Spreedly • Airwallex → Airwallex • NMI → NMI • Auth → Auth • Primer → Primer • Payarc → Payarc • PaymentKit → PaymentKit • Chargebee → Chargebee • Phoenix → Phoenix • Adyen → Adyen • Recurly → Recurly • Gr4vy → Gr4vy • Recharge → Recharge • Openpay → Openpay • Finix → Finix • Worldpay → Worldpay • FMJ → FMJ • Coinflow → Coinflow • Xecom → Xecom • Vrio → Vrio • Checkout → Checkout • a55 → a55 • Seal → Seal • GuestyPay → GuestyPay • Fyntek → Fyntek • Paytech → Paytech • SwissCRM → SwissCRM • Paysight → Paysight • Whop → Whop • Spark → Spark • Kurv → Kurv • Everflow → Everflow • IMerchant → IMerchant • RocketGate → RocketGate - `chargeId` string, required: Chargeblast charge id linked to this dispute. - `accountId` string, nullable - `brand` 'mastercard' | 'visa' | 'amex' | 'discover' | 'unknown' | '', required - `funding` 'credit' | 'debit' | 'prepaid' | '' - `createdAt` string, date-time, nullable - `subscriptionId` string, nullable - `subAccountId` string, nullable - `disputeStatus` 'needs_response' | 'under_review' | 'charge_refunded' | 'won' | 'lost' | 'protected' | 'prevented', nullable: Current dispute status: needs_response, under_review, charge_refunded, won, lost, protected, or prevented. - `reason` string, nullable: Issuer dispute reason (e.g. fraudulent, product_not_received, unrecognized). - `isRDR` boolean, nullable: Whether the dispute was deflected via RDR. - `riskScore` number, double, nullable - `userId` string, required: Chargeblast company id that owns this dispute. - `issuer` string, nullable - `amountUSD` number, double, nullable: Disputed amount converted to USD cents. - `customerEmail` string, nullable - `authorizationCode` string, nullable - `streamId` string, nullable - `arn` string, nullable: Acquirer Reference Number of the original charge. - `is3DS` boolean, nullable - `expirationDate` string, date-time, nullable: Deadline to respond to the dispute, when the processor supplies one. - `kind` 'chargeback' | 'inquiry' | 'pre_arbitration' | 'second_chargeback' - `daysLeftToRespond` string, required: Human-readable time remaining to respond, e.g. `12 days` or `Expires soon`. - `explanation` 'alert_not_handled' | 'alerted_refunded_late' | 'alerted_bank_violated_sop' | 'alert_safe_failed' | 'alert_rejected' | 'alert_unknown' | 'rdr_deflected' | 'out_of_coverage' | 'alert_marked_as_already_refunded' | 'descriptor_not_enrolled' | 'descriptor_enrolled_out_of_coverage' | 'dispute_on_debit_network' | 'no_arn' | 'alert_update_request_failed' | 'unknown' - `supportsAutoRepresentment` boolean, required - `alertId` string, nullable: Linked alert id when Chargeblast has enriched this dispute. - `externalUrl` string, nullable - `winLikelihood` DisputeWinLikelihoodDTO - `score` number, double, required: Probability that the merchant wins the dispute, from 0 to 1. - `computedAt` string, date-time, required - `modelVersion` string, required - `source` string, required - `isBilled` boolean, nullable: Whether Chargeblast has billed this recovery. Omitted until the dispute is enriched. - `invoicedDate` string, date-time, nullable: When Chargeblast invoiced this recovery. Omitted until the dispute is enriched. - `submissionDate` string, date-time, nullable: When evidence was submitted. Omitted if evidence was never submitted. - `isManagedByChargeblast` boolean, nullable: Whether Chargeblast is fighting this dispute on your behalf. Omitted until the dispute is enriched. - `isSubmittedEvidenceByChargeblast` boolean, nullable: Whether Chargeblast submitted evidence for this dispute. Omitted until the dispute is enriched. - `alerts` ExportAlert[], required: Alerts (Ethoca, CDRN, RDR, TC40) linked to the charge behind this dispute, if any. - `provider` string, nullable: Provider associated with the alert. Possible values: ethoca, verifi - `id` string, required: Id for the alert. - `card` string, nullable: The redacted card number, e.g., 424242****1234. - `issuer` string, nullable: Issuer of the card (e.g., bank or financial institution). - `invoicedAt` string, date-time, nullable: Date and time when the alert was invoiced. - `authCode` string, nullable: Authorization code for the transaction, if available. - `site` string, nullable: Merchant's website or site string associated with the alert. - `customerEmail` string, nullable: Customer's email address associated with the alert, if available. - `creditStatus` string, nullable: Status of the credit (if any) associated with the alert. - `alertType` string, required: Type of alert, e.g., FRAUD, DISPUTE. - `creditAppealed` boolean, required: Indicates if the credit associated with the alert was appealed. - `currency` string, nullable: Currency code in ISO format (e.g., USD, EUR) for the transaction. - `reasonCode` string, nullable: Reason code associated with the alert, often indicating the nature of the dispute. - `createdAt` string, date-time, required: Date and time when the alert was created. - `merchantId` string, nullable: Identifier for the merchant within the system. - `acquirerAction` string, nullable: Actions taken by the acquirer in response to the alert. Only relevant for RDR and other acquirer side alerts - either Resolved or Declined. - `alertId` string, nullable: Unique identifier for the alert within the provider's system. Will match the id field. - `amount` number, double, required: Transaction amount for the alert. $139.38 will be represented as 139.38 - `resolvedDate` string, date-time, nullable: Date and time when the alert was resolved. - `resolvedByApi` boolean, nullable: Indicates if the alert was resolved via API. - `externalOrder` string, nullable: External charge id related to the alert. - `externalUrl` string, nullable: URL linking to an external reference for the alert. - `creditNotes` string, nullable: Additional notes or information regarding the credit status. - `arn` string, nullable: Acquirer Reference Number, unique identifier for the transaction. - `attributes` object, nullable: Optional string key-value metadata associated with the alert. Included on webhook payloads and when fetching alerts via the API when present. - `transactionDate` string, date-time, required: Date and time when the transaction took place. - `customerId` string, nullable: Unique identifier for the customer associated with the alert, if available. - `descriptor` string, nullable: Billing descriptor shown on the card statement. - `subprovider` string, required: Specific sub-provider within the provider service. - `cardBrand` string, nullable: The card network (e.g., Visa, Mastercard, Amex). - `responseAction` string, nullable: Response action taken in response to the alert. - `deflections` ExportDeflection[], required: Compelling Evidence / Fast Pay Thru deflections linked to the charge behind this dispute, if any. - `chargeId` string, required - `type` string, required: Deflection type: `CE` (Compelling Evidence) or `FPT` (Fast Pay Thru). - `network` string, required: `OI` (Order Insights) or `CC` (Consumer Clarity). - `status` string, required - `amount_usd` number, double, required: Deflected amount in USD cents. - `currency` string, required - `deflectionDate` string, date-time, required - `submissions` ChargeSubmissionDTO[], required: Evidence submissions filed for this dispute, if any, each with its evidence documents. - `id` string, nullable - `isBilled` boolean, required - `isManual` boolean, required - `createdAt` string, date-time, nullable - `disputeEnrichedId` string, nullable - `commonDisputeDirectId` string, nullable - `evidence` ChargeSubmissionEvidenceDTO[], required - `id` string, nullable - `isSubmittedToProcessor` boolean, required - `url` string, required - `createdAt` string, date-time, nullable - `submittedByAccountId` string, nullable - `page` integer, required: The current page. - `per` integer, required: How many objects are returned per page. - `total` integer, required: Total number of disputes matching the filter. --- [API](https://skmtc.dev/chargeblast/apis/chargeblast-api-2.md) · [All operations](https://skmtc.dev/chargeblast/apis/chargeblast-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/chargeblast/apis/chargeblast-api-2/revisions/882dd27a5692?raw)