Wise

Wise Disputes API

Raise and manage card transaction disputes, including submission via Dynamic Flow or direct API, file uploads, and dispute lifecycle tracking. For implementation details, see: - [Disputes via Dynamic Flow](/guides/product/issue-cards/card-disputes-dynamic-flow) — build a dispute UI using the Dynamic Flow framework - [Disputes via API](/guides/product/issue-cards/card-disputes-api) — submit disputes directly, with per-reason request body details - [Dispute management](/guides/product/issue-cards/card-disputes-management) — track and withdraw disputes Dispute sub-statuses {% #dispute-sub-status .title-3 .m-t-5 %} The possible `subStatus` values are: - `SUBMITTED` — Initial status - `IN_REVIEW` — The dispute is under review or requires additional information - `REFUNDED` — The refund has been processed - `REJECTED` — The dispute is invalid - `WITHDRAWN` — The customer has withdrawn the dispute - `CONFIRMED` — The dispute has been reviewed but a refund is not applicable - `REFUND_IN_PROGRESS` — A refund is being processed - `ATTEMPTING_RECOVERY` — A chargeback request has been submitted - `RECOVERY_UNSUCCESSFUL` — The chargeback attempt was unsuccessful {% admonition type="warning" %} The status transition diagram may undergo modifications in the future and only covers regular pathways. {% /admonition %} {% img src="/images/diagrams/dispute-status-flow.png" alt="Dispute statuses transition diagram" /%}

GitHub OpenAPI
Business capability
Card Transaction Processing Management BC-1340.70

Operations 8

POST /v3/spend/profiles/{profileId}/dispute-form/flows/step/{scheme}/{reason} Dispute dynamic flow entry point #
GET /v3/spend/profiles/{profileId}/dispute-form/reasons Retrieve dispute reasons #
POST /v3/spend/profiles/{profileId}/dispute-form/flows/{scheme}/{reason} Submit dispute #
POST /v4/spend/profiles/{profileId}/dispute-form/file Upload dispute file #
GET /v3/spend/profiles/{profileId}/disputes List disputes #
GET /v3/spend/profiles/{profileId}/disputes/{disputeId} Get dispute #
PUT /v3/spend/profiles/{profileId}/disputes/{disputeId}/status Withdraw dispute #
POST /v3/spend/profiles/{profileId}/dispute-form/file Upload dispute file (v3) #

Documentation

📖
Documentation
https://docs.wise.com/api-docs/api-reference/profile
📖
Documentation
https://docs.wise.com/api-docs/api-reference/recipient
📖
Documentation
https://docs.wise.com/api-docs/api-reference/quote
📖
Documentation
https://docs.wise.com/api-docs/api-reference/transfer
📖
Documentation
https://docs.wise.com/api-docs/api-reference/balance
📖
Documentation
https://docs.wise.com/api-docs/api-reference/multi-currency-account
📖
Documentation
https://docs.wise.com/api-docs/api-reference/balance-statement
📖
Documentation
https://docs.wise.com/api-docs/api-reference/card
📖
Documentation
https://docs.wise.com/api-docs/api-reference/subscription
📖
Documentation
https://docs.wise.com/api-docs/api-reference/simulation

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/wise/refs/heads/main/openapi/wise-disputes-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/wise/refs/heads/main/asyncapi/wise-webhooks-asyncapi.yml

Other Resources

🔗
Sandbox
https://api.sandbox.transferwise.tech

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/wise-disputes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

wise-disputes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Wise Platform Disputes API
  version: ''
  description: The Wise Platform API is a REST-based interface that enables programmatic access to Wise's payment infrastructure.
servers:
- url: https://api.wise.com
  description: Production Environment
- url: https://api.wise-sandbox.com
  description: Sandbox Environment
tags:


# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/wise/refs/heads/main/openapi/wise-disputes-api-openapi.yml