Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

magento Orders API

Sales order management including order retrieval, status updates, comment posting, cancellation, and order item management.

magento Orders API is one of 16 APIs that magento publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Orders. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 4 paths, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 2.4.

Requests are made against a single base URL, https://{store_domain}/rest/{store_code}.

5 operations 4 paths 7 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.4
Base URL
https://your-store.example.com/rest
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

magento Orders API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Bearer token obtained from the /V1/integration/admin/token or /V1/integration/customer/token endpoint. Include in the Authorization header as "Bearer {token}".

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Orders 5

Sales order management including order retrieval, status updates, comment posting, cancellation, and order item management.

GET
/V1/orders
List orders
listOrders 4 params → 200400401
POST
/V1/orders
Create an order
createOrder body → 200400401
GET
/V1/orders/{orderId}
Get order by ID
getOrder 1 param → 200401404
POST
/V1/orders/{orderId}/cancel
Cancel an order
cancelOrder 1 param → 200400401404
POST
/V1/orders/{orderId}/comments
Add a comment to an order
addOrderComment 1 param body → 200400401404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Order (18 properties), OrderItem (10 properties), Address (10 properties), OrderSearchResults (3 properties). Each schema is shown below with its type and property counts.

OrderSearchResults
object
Paginated search results containing a list of orders.
3 properties
Address
object
A postal address used for billing or shipping.
10 properties
OrderItem
object
A line item within a sales order.
10 properties
OrderRequest
object
Request body for creating a sales order directly via the API.
1 property 1 required
OrderCommentRequest
object
Request body for adding a status history comment to an order.
1 property 1 required
Order
object
A sales order in Adobe Commerce.
18 properties
Error
object
Standard error response returned for 4xx and 5xx responses.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

magento-orders-api-openapi.yml Raw ↑

Other APIs magento publishes across the network.

Magento GraphQL API
Magento SOAP API
Adobe Commerce Webhooks
Adobe Commerce Admin UI SDK
Adobe Commerce Eventing
magento Authentication API
magento Carts API
magento Categories API
magento Customers API
magento Inventory API
magento Invoices API
magento Products API