Smithy · Example Payload

Smithy Simple Service Example

A simple Smithy 2.0 service model in JSON AST format demonstrating a basic CRUD resource API

Code GenerationIDLSDKAPI DesignInterface Definition LanguageToolchain

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

Top-level fields

descriptionformatversionmodel

Example Payload

{
  "description": "A simple Smithy 2.0 service model in JSON AST format demonstrating a basic CRUD resource API",
  "format": "Smithy JSON AST",
  "version": "2.0",
  "model": {
    "smithy": "2.0",
    "metadata": {
      "suppressions": []
    },
    "shapes": {
      "com.example#WeatherService": {
        "type": "service",
        "version": "2026-05-02",
        "resources": [
          {"target": "com.example#City"}
        ],
        "traits": {
          "aws.protocols#restJson1": {},
          "smithy.api#title": "Weather Service"
        }
      },
      "com.example#City": {
        "type": "resource",
        "identifiers": {
          "cityId": {"target": "com.example#CityId"}
        },
        "read": {"target": "com.example#GetCity"},
        "list": {"target": "com.example#ListCities"},
        "resources": [
          {"target": "com.example#Forecast"}
        ]
      },
      "com.example#GetCity": {
        "type": "operation",
        "input": {"target": "com.example#GetCityInput"},
        "output": {"target": "com.example#GetCityOutput"},
        "errors": [
          {"target": "com.example#NoSuchResource"}
        ],
        "traits": {
          "smithy.api#http": {
            "method": "GET",
            "uri": "/cities/{cityId}",
            "code": 200
          },
          "smithy.api#readonly": {}
        }
      },
      "com.example#GetCityInput": {
        "type": "structure",
        "members": {
          "cityId": {
            "target": "com.example#CityId",
            "traits": {
              "smithy.api#httpLabel": {},
              "smithy.api#required": {}
            }
          }
        }
      },
      "com.example#GetCityOutput": {
        "type": "structure",
        "members": {
          "name": {
            "target": "smithy.api#String",
            "traits": {
              "smithy.api#required": {}
            }
          },
          "coordinates": {
            "target": "com.example#CityCoordinates"
          }
        }
      },
      "com.example#CityId": {
        "type": "string",
        "traits": {
          "smithy.api#pattern": "^[A-Za-z0-9 ]+$"
        }
      },
      "com.example#CityCoordinates": {
        "type": "structure",
        "members": {
          "latitude": {
            "target": "smithy.api#Float",
            "traits": {"smithy.api#required": {}}
          },
          "longitude": {
            "target": "smithy.api#Float",
            "traits": {"smithy.api#required": {}}
          }
        }
      },
      "com.example#NoSuchResource": {
        "type": "structure",
        "members": {
          "resourceType": {
            "target": "smithy.api#String",
            "traits": {"smithy.api#required": {}}
          }
        },
        "traits": {
          "smithy.api#error": "client",
          "smithy.api#httpError": 404
        }
      }
    }
  }
}

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-simple-service-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.