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

Zalando AnnouncedReturns API

The AnnouncedReturns API from Zalando — 1 operation(s) for announcedreturns.

Zalando AnnouncedReturns API is one of 20 APIs that Zalando publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 1 operation across 1 path, and defines 9 schemas. It is described by OpenAPI 3.0.2, at version 1.0.0.

Requests are made against the base URL https://api.merchants.zalando.com.

1 operations 1 paths 9 schemas 1 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
1.0.0
Base URL
https://api.merchants.zalando.com
Resource Areas
1

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 GET. Each is listed below with its method, path, parameters, and response codes.

AnnouncedReturns 1
GET
/merchants/{merchant-id}/announced-returns
Retrieve the returns announced by customers via Zalando website.
9 params → 200429default

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are AnnouncedReturn (6 properties), Error (5 properties), AnnouncedReturnOrder (4 properties), AnnouncedReturnOrderLine (3 properties). Each schema is shown below with its type and property counts.

AnnouncedReturn
object
A return announced by a customer via Zalando website. It's possible that a single announced return contains items from multiple orders.
6 properties 6 required
Errors
object
An array of error objects.
1 property
RateLimitError
object
Error object for rate limit.
1 property
Error
object
Error object
5 properties
AnnouncedReturns
object
A collection of returns announced by customers via Zalando website.
2 properties 2 required
AnnouncedReturnOrderLine
object
The Order Line information in the announced return.
3 properties 3 required
ErrorSource
object
Indicate the source of error.
2 properties
BaseLinks
object
Links for cursor-based navigation.
3 properties 1 required
AnnouncedReturnOrder
object
The Order information in the announced return.
4 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zalando-announcedreturns-api-openapi.yml Raw ↑

Other APIs Zalando publishes across the network.

Zalando attribute-types API
Zalando attribute-values API
Zalando Attributes API
Zalando Cross Border Movements API
Zalando Discovery API API
Zalando History of Price Update Attempts API
Zalando Liquidated Items API
Zalando Logistic Centers API
Zalando offer-blockers API
Zalando Orders API
Zalando Outlines API
Zalando prices API