# Swap Returns API

**Canonical:** https://apis.io/apis/swap/swap-returns-api/  
**Provider:** Swap — https://apis.io/providers/swap/  
**Base URL:** https://api-gateway.swap-os.com/returns-api  
**Documentation:** https://docs.api-swap-os.com/products/returns/

Swap Returns API is one of 6 APIs that [Swap](https://apis.io/providers/swap/) publishes on the [APIs.io](https://apis.io/) network. The published artifact set on APIs.io includes API documentation and an API reference.

Public API for Swap Returns reverse logistics: list external returns (V1 and V2) and update quality-control status, with per-store JWT-signed webhooks for return lifecycle events.

## Machine-readable artifacts (2)

- **Documentation** — https://docs.api-swap-os.com/products/returns/
- **APIReference** — https://docs.api-swap-os.com/products/returns/returns-reference/get-external-returns-v-2/

## Other Swap APIs (5)

- [Swap Agentic Storefront API](https://apis.io/apis/swap/swap-agentic-storefront-api/)
- [Swap Global API](https://apis.io/apis/swap/swap-global-api/)
- [Swap Protect API](https://apis.io/apis/swap/swap-protect-api/)
- [Swap Shipping API](https://apis.io/apis/swap/swap-shipping-api/)
- [Swap TLC API](https://apis.io/apis/swap/swap-tlc-api/)

---

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