# Medusa Orders API

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

Medusa Orders 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 Order. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

An order is a purchase made by a customer through a storefront. Orders can also originally be created as draft orders. These API routes allow admin users to view and manage orders.

## Operations (26)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/orders` | List Orders |
| POST | `/admin/orders/export` | Export Orders |
| GET | `/admin/orders/{id}` | Get an Order |
| POST | `/admin/orders/{id}` | Update Order |
| POST | `/admin/orders/{id}/archive` | Archive an Order |
| POST | `/admin/orders/{id}/cancel` | Cancel Order |
| GET | `/admin/orders/{id}/changes` | List Changes on an Order |
| POST | `/admin/orders/{id}/complete` | Complete Order |
| POST | `/admin/orders/{id}/credit-lines` | Create Credit Line for Order |
| POST | `/admin/orders/{id}/fulfillments` | Create an Order Fulfillment |
| POST | `/admin/orders/{id}/fulfillments/{fulfillment_id}/cancel` | Cancel Fulfillment |
| POST | `/admin/orders/{id}/fulfillments/{fulfillment_id}/mark-as-delivered` | Mark a Fulfillment as Delivered. |
| POST | `/admin/orders/{id}/fulfillments/{fulfillment_id}/shipments` | Create Shipment for an Order's Fulfillment |
| GET | `/admin/orders/{id}/line-items` | List Line Items |
| POST | `/admin/orders/{id}/payment-sessions/authorize` | Authorize Payment Session |
| GET | `/admin/orders/{id}/preview` | Get Preview |
| GET | `/admin/orders/{id}/shipping-options` | List Shipping Options for Order |
| POST | `/admin/orders/{id}/transfer` | Request Order Transfer |
| POST | `/admin/orders/{id}/transfer/cancel` | Cancel Transfer Request |
| POST | `/admin/orders/{id}/transfer/guest` | Transfer Order to Guest Customer |
| GET | `/store/orders` | List Logged-in Customer's Orders |
| GET | `/store/orders/{id}` | Get an Order |
| POST | `/store/orders/{id}/transfer/accept` | Accept Order Transfer |
| POST | `/store/orders/{id}/transfer/cancel` | Cancel Order Transfer |
| POST | `/store/orders/{id}/transfer/decline` | Decline Order Transfer |
| POST | `/store/orders/{id}/transfer/request` | Request Order Transfer |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/medusa/refs/heads/main/openapi/medusa-orders-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 Claims API](https://apis.io/apis/medusa/medusa-claims-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/)

## Tags

Order

---

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