API Specifications · Example Payload

Smithy Example

SmithyIDLSpecification Language

Smithy Example is an example object payload from API Specifications, with 17 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

idnamealiasescategorycurrentVersionversionsgoverningBodylicenseformattransportsprimaryUseCasespecificationUrldocumentationUrlrepositoryUrltagsstatusemits

Example Payload

{
  "id": "smithy",
  "name": "Smithy",
  "aliases": [],
  "category": "Service Interface (IDL)",
  "currentVersion": "2.0",
  "versions": [
    { "version": "2.0", "status": "active", "url": "https://smithy.io/2.0/spec/index.html" },
    { "version": "1.0", "status": "deprecated", "url": "https://smithy.io/1.0/spec/index.html" }
  ],
  "governingBody": {
    "name": "Smithy-Lang (Amazon Web Services)",
    "url": "https://smithy.io/"
  },
  "license": {
    "id": "Apache-2.0",
    "url": "https://www.apache.org/licenses/LICENSE-2.0"
  },
  "format": "DSL",
  "transports": ["HTTP/1.1", "HTTP/2", "MQTT", "gRPC", "Multiple"],
  "primaryUseCase": "Define protocol-agnostic service contracts using traits-based modeling and generate AWS SDKs, OpenAPI, JSON Schema, and clients/servers across multiple protocols.",
  "specificationUrl": "https://smithy.io/2.0/spec/index.html",
  "documentationUrl": "https://smithy.io/2.0/quickstart.html",
  "repositoryUrl": "https://github.com/smithy-lang/smithy",
  "tags": ["Smithy", "AWS", "IDL", "Specification Language"],
  "status": "active",
  "emits": ["OpenAPI 3.0", "JSON Schema", "AWS JSON 1.0/1.1"]
}

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/smithy-example"

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.