How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Zalando

Zalando Orders API

The Orders API from Zalando — 11 operation(s) for orders.

Documentation Provider Profile APIs.io OpenAPI GitHub

Zalando Orders API is one of 20 APIs that Zalando publishes on the 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 and an API reference.

This API exposes 15 operations across 11 paths, and defines 51 schemas. It is described by OpenAPI 3.2.0, at version 1.1.1.

Requests are made against a single base URL, https://api-sandbox.merchants.zalando.com.

15 operations 11 paths 51 schemas 11 GET3 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1.1
Base URL
https://api.merchants.zalando.com
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zalando Orders API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (merchant_platform) using the clientCredentials flow, exposing 2 scopes. By default, every request must be authenticated.

  • merchant_platform — This API uses OAuth2 OIDC with Client Credentials flow.

Paths & Operations 15

Across 11 paths, the API surfaces 15 operations — 11 GET, 3 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Orders 15
GET
/merchants/{merchant-id}/orders
Retrieves the merchant orders. Allows filtering of the orders by creation and modified date.
17 params → 200403404429default
GET
/merchants/{merchant-id}/orders/{order-id}
Retrieves an order by order-id.
5 params → 200403404429default
PATCH
/merchants/{merchant-id}/orders/{order-id}
Partially updates the order.
4 params body → 204400403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/transitions
Retrieves all state transitions for a given order-id.
4 params → 200403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/shipments
Get shipments for the order
4 params → 200403404429
POST
/merchants/{merchant-id}/orders/{order-id}/shipments
Create a shipment.
4 params body → 201400403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/shipments/{shipment-id}
Get an individual shipment
5 params → 200403404429
PATCH
/merchants/{merchant-id}/orders/{order-id}/shipments/{shipment-id}
Update a shipment
5 params body → 204400403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/items
Retrieves all order items for a given order-id.
5 params → 200403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/items/{order-item-id}
Retrieves an order item with the given identifier.
6 params → 200403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/items/{order-item-id}/lines
Retrieves the Order Lines of an order item.
6 params → 200403404429default
GET
/merchants/{merchant-id}/orders/{order-id}/items/{order-item-id}/lines/{order-line-id}
Retrieves an Order Line with the given identifier.
7 params → 200403404429default
PATCH
/merchants/{merchant-id}/orders/{order-id}/items/{order-item-id}/lines/{order-line-id}
Updates the Order Line status with the provided status.
6 params body → 204400403404409429default
GET
/merchants/{merchant-id}/orders/{order-id}/items/{order-item-id}/lines/{order-line-id}/transitions
Retrieves all transitions that happened at the Order Line level.
6 params → 200403404429default
GET
/merchants/{merchant-id}/orders-deletion-requests
Retrieves the order data belonging to customers who requested data deletion.
6 params → 200403404429default

Schemas 51

The contract defines 51 schemas that model the data the API accepts and returns. The most detailed are OrderAttributes (29 properties), OrderItemAttributes (14 properties), OrderLineAttributes (12 properties), Shipment (11 properties). Each schema is shown below with its type and property counts.

OrderItemAttributes
object
An Order Item contains a summarized view with quantities of the underlying Order Lines.
14 properties 6 required
Order
object
Order Resource Object.
6 properties
Address
object
The representation of an address.
10 properties 6 required
OrderItemsTopLevel
object
Representation of a list of order items according to the JSON API specification.
4 properties
OrderUpdateAttributes
object
Attributes belonging to an order update.
3 properties
ServicePointDetails
object
3 properties
OrderLineStatus
string
The status of an Order Line.
RateLimitError
object
Error object for rate limit.
1 property
ShipmentResource
object
Shipment resource object
3 properties
OrderResourceObject
DeletionRequestOrder
object
Representation of an order to be deleted.
7 properties
OrderLineUpdateTopLevel
object
Representation of an Order Line update according to the JSON API specification.
1 property
Relationships
object
Relationship object to represent One-to-Many relationships.
2 properties
Phone
object
The phone number of the customer who placed the order. It's exposed only with required permissions
1 property 1 required
OrderRelationships
object
Order relationships.
2 properties
TransitionsTopLevel
object
Representation of a list of transitions according to the JSON API specification.
3 properties
TransitionReason
object
The reason for an order or order line transition.
2 properties 2 required
Meta
object
Meta
3 properties 1 required
Shipment
object
A shipment represents the delivery of specific order lines from an order in a single parcel. It includes additional details such as tracking numbers, the stock…
11 properties 1 required
OrderItem
object
Order Item Resource Object.
6 properties
OrderAttributes
object
Representation of an order.
29 properties 8 required
Error
object
Error object
5 properties
OrderLineTopLevel
object
Representation of an Order Line according to the JSON API specification.
4 properties
Errors
object
An array of error objects.
1 property
OrderLine
object
OrderLine resource object
6 properties
Links
object
Links response
6 properties
OrderLineUpdateAttributes
object
Attribute belonging to an Order Line update.
3 properties 1 required
ResourceIdentifierObject
object
Resource Identifier Object which uniquely identifies a Resource Object.
2 properties 2 required
LineResourceObject
OrderLinesTopLevel
object
Representation of a list of Order Lines according to the JSON API specification.
4 properties
OrderLineAttributes
object
A detailed view of an Order Item - a single line of possible multiple Order Lines.
12 properties 2 required
Weight
object
The weight measurement
2 properties 2 required
Money
object
2 properties 2 required
ErrorSource
object
Indicate the source of error.
2 properties
ShipmentStatus
string
The status of the shipment.
OrderStatus
string
The status of an order.
OrderUpdateData
object
Data of an order update.
3 properties 3 required
Cursor
object
The representation of a cursor for fetching paginated list of orders for deletion.
1 property
ShipmentOrderLine
object
Shipment related attributes of an order line
2 properties 1 required
OrderLineUpdateData
object
Data of an Order Line update.
3 properties 3 required
OrderTopLevel
object
Representation of an order according to the JSON API specification.
4 properties
Shipments
object
A collection of shipments for this order.
1 property
OrderItemTopLevel
object
Representation of an order item according to the JSON API specification.
4 properties
OrderUpdateTopLevel
object
Representation of an order update according to the JSON API specification.
1 property
TransitionAttributes
object
Details of a state transition for an Order or Order Line
5 properties 4 required
DeletionRequests
object
Representation of a deletion request containing list of orders with details to be deleted
2 properties
OrderLineRelationships
object
Order Line relationships.
1 property
ItemResourceObject
OrderItemRelationships
object
Order Item relationships.
1 property
TransitionData
object
Transition resource object.
5 properties
OrdersTopLevel
object
Representation of a list of orders according to the JSON API specification.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zalando-orders-api-openapi.yml Raw ↑

Other APIs Zalando publishes across the network.

Zalando AnnouncedReturns API
AE Profile APIs.io
Zalando attribute-types API
AE Profile APIs.io
Zalando attribute-values API
AE Profile APIs.io
Zalando Attributes API
AE Profile APIs.io
Zalando Cross Border Movements API
AE Profile APIs.io
Zalando Discovery API API
AE Profile APIs.io
Zalando History of Price Update Attempts API
AE Profile APIs.io
Zalando Liquidated Items API
AE Profile APIs.io
Zalando Logistic Centers API
AE Profile APIs.io
Zalando offer-blockers API
AE Profile APIs.io
Zalando Outlines API
AE Profile APIs.io
Zalando prices API
AE Profile APIs.io
#Order
← Back to Z APIs
API Details
ID
zalando:zalando-orders-api
Base URL
https://api.merchants.zalando.com
Docs
https://developers.merchants.zalando.com/docs/openapi/orders.html
Provider
Zalando
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=zalando-orders-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/zalando-orders-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Zalando Orders API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.