# Medusa Claims API

**Canonical:** https://apis.io/apis/medusa/medusa-claims-api/  
**Provider:** Medusa — https://apis.io/providers/medusa/  
**Base URL:** https://{medusa-backend-domain}  
**Documentation:** https://docs.medusajs.com/api/store

Medusa Claims API is one of 82 APIs that [Medusa](https://apis.io/providers/medusa/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Claims. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

An admin creates a claim for an order when a customer reports that an item is defective or incorrect. Using these API routes, admin users manage order claims, their items, and more.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/claims` | List Claims |
| POST | `/admin/claims` | Create a Claim |
| GET | `/admin/claims/{id}` | Get a Claim |
| POST | `/admin/claims/{id}/cancel` | Cancel a Claim |
| POST | `/admin/claims/{id}/claim-items` | Add Claim Items to a Claim |
| POST | `/admin/claims/{id}/claim-items/{action_id}` | Update a Claim Item |
| DELETE | `/admin/claims/{id}/claim-items/{action_id}` | Remove a Claim Item from a Claim |
| POST | `/admin/claims/{id}/inbound/items` | Add Inbound Items to a Claim |
| POST | `/admin/claims/{id}/inbound/items/{action_id}` | Update Inbound Items of a Claim |
| DELETE | `/admin/claims/{id}/inbound/items/{action_id}` | Remove an Inbound Item from Claim |
| POST | `/admin/claims/{id}/inbound/shipping-method` | Add an Inbound Shipping Method to a Claim |
| POST | `/admin/claims/{id}/inbound/shipping-method/{action_id}` | Update Inbound Shipping Method of a Claim |
| DELETE | `/admin/claims/{id}/inbound/shipping-method/{action_id}` | Remove Inbound Shipping Method from Claim |
| POST | `/admin/claims/{id}/outbound/items` | Add Outbound Items to a Claim |
| POST | `/admin/claims/{id}/outbound/items/{action_id}` | Update Outbound Item of a Claim |
| DELETE | `/admin/claims/{id}/outbound/items/{action_id}` | Remove an Outbound Item from Claim |
| POST | `/admin/claims/{id}/outbound/shipping-method` | Add Outbound Shipping Methods to a Claim |
| POST | `/admin/claims/{id}/outbound/shipping-method/{action_id}` | Update Outbound Shipping Method of a Claim |
| DELETE | `/admin/claims/{id}/outbound/shipping-method/{action_id}` | Remove Outbound Shipping Method from Claim |
| POST | `/admin/claims/{id}/request` | Confirm a Claim Request |
| DELETE | `/admin/claims/{id}/request` | Cancel Claim Request |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/medusa/refs/heads/main/openapi/medusa-claims-api-openapi.yml
- **Documentation** — https://docs.medusajs.com/api/store
- **APIReference** — https://docs.medusajs.com/api/store
- **OpenAPI Source** — https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yaml
- **Authentication** — https://docs.medusajs.com/api/store#authentication
- **Documentation** — https://docs.medusajs.com/api/admin
- **APIReference** — https://docs.medusajs.com/api/admin
- **OpenAPI Source** — https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/admin/openapi.full.yaml
- **Authentication** — https://docs.medusajs.com/api/admin#authentication

## Other Medusa APIs (12)

- [Medusa GraphQL API](https://apis.io/apis/medusa/medusa-graphql-api/)
- [Medusa MCP Remote Server](https://apis.io/apis/medusa/medusa-mcp-server/)
- [Medusa Api Keys API](https://apis.io/apis/medusa/medusa-api-keys-api/)
- [Medusa Auth API](https://apis.io/apis/medusa/medusa-auth-api/)
- [Medusa [auth Provider] API](https://apis.io/apis/medusa/medusa-auth-provider-api/)
- [Medusa Campaigns API](https://apis.io/apis/medusa/medusa-campaigns-api/)
- [Medusa Carts API](https://apis.io/apis/medusa/medusa-carts-api/)
- [Medusa Collections API](https://apis.io/apis/medusa/medusa-collections-api/)
- [Medusa Currencies API](https://apis.io/apis/medusa/medusa-currencies-api/)
- [Medusa Customer Groups API](https://apis.io/apis/medusa/medusa-customer-groups-api/)
- [Medusa Customers API](https://apis.io/apis/medusa/medusa-customers-api/)
- [Medusa Draft Orders API](https://apis.io/apis/medusa/medusa-draft-orders-api/)

## Tags

Claims

---

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