API Style Guides · Example Payload

Zalando 101 Openapi

OpenAPIDocumentation

Zalando 101 Openapi is an example object payload from API Style Guides, with 14 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

$schemaidguideleveltitlesummarycategoryrationaleappliesTosourceUrlreferencesspectralRulerelatedRulestags

Example Payload

{
  "$schema": "../json-schema/style-guide-rule-schema.json",
  "id": "zalando-101",
  "guide": "style-guides:zalando",
  "level": "MUST",
  "title": "Provide API Specification Using OpenAPI",
  "summary": "Every REST API at Zalando must be specified in OpenAPI. The OpenAPI document is the human- and machine-readable source of truth and is required for consumer review.",
  "category": "Documentation",
  "rationale": "A single specification format makes APIs lintable, mockable, and consumable by SDK generators and gateways without per-team divergence.",
  "appliesTo": ["REST"],
  "sourceUrl": "https://opensource.zalando.com/restful-api-guidelines/#101",
  "references": [
    {
      "url": "https://spec.openapis.org/oas/latest.html",
      "title": "OpenAPI Specification",
      "type": "Spec"
    }
  ],
  "spectralRule": {
    "given": "$",
    "then": { "field": "openapi", "function": "truthy" },
    "severity": "error"
  },
  "relatedRules": ["aip-191"],
  "tags": ["OpenAPI", "Documentation"]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/zalando-101-openapi"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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