# Wise disputes API

**Canonical:** https://apis.io/apis/wise/wise-disputes-api/  
**Provider:** Wise — https://apis.io/providers/wise/  
**Base URL:** https://api.wise.com/v2  
**Documentation:** https://docs.wise.com/api-docs/api-reference/profile

Wise disputes API is one of 47 APIs that [Wise](https://apis.io/providers/wise/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include Disputes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

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" /%}

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/wise/refs/heads/main/openapi/wise-disputes-api-openapi.yml
- **Documentation** — https://docs.wise.com/api-docs/api-reference/profile
- **Sandbox** — https://api.sandbox.transferwise.tech
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/wise/refs/heads/main/graphql/wise-graphql.md
- **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
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/wise/refs/heads/main/asyncapi/wise-webhooks-asyncapi.yml
- **Documentation** — https://docs.wise.com/api-docs/api-reference/simulation

## Other Wise APIs (12)

- [Wise 3ds API](https://apis.io/apis/wise/wise-3ds-api/)
- [Wise activity API](https://apis.io/apis/wise/wise-activity-api/)
- [Wise address API](https://apis.io/apis/wise/wise-address-api/)
- [Wise balance API](https://apis.io/apis/wise/wise-balance-api/)
- [Wise balance-statement API](https://apis.io/apis/wise/wise-balance-statement-api/)
- [Wise bank-account-details API](https://apis.io/apis/wise/wise-bank-account-details-api/)
- [Wise batch-group API](https://apis.io/apis/wise/wise-batch-group-api/)
- [Wise bulk-settlement API](https://apis.io/apis/wise/wise-bulk-settlement-api/)
- [Wise card API](https://apis.io/apis/wise/wise-card-api/)
- [Wise card-kiosk-collection API](https://apis.io/apis/wise/wise-card-kiosk-collection-api/)
- [Wise card-order API](https://apis.io/apis/wise/wise-card-order-api/)
- [Wise card-sensitive-details API](https://apis.io/apis/wise/wise-card-sensitive-details-api/)

## Tags

Disputes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/wise/wise-disputes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/wise/.