API Specifications · Example Payload

Typespec Example

TypeSpecMicrosoftIDLSpecification Language

Typespec 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": "typespec",
  "name": "TypeSpec",
  "aliases": ["Cadl"],
  "category": "Service Interface (IDL)",
  "currentVersion": "1.x",
  "versions": [
    { "version": "1.x", "status": "active", "url": "https://typespec.io/docs" }
  ],
  "governingBody": {
    "name": "Microsoft",
    "url": "https://typespec.io/",
    "governanceUrl": "https://github.com/microsoft/typespec/blob/main/GOVERNANCE.md"
  },
  "license": {
    "id": "MIT",
    "url": "https://opensource.org/license/mit"
  },
  "format": "DSL",
  "transports": ["HTTP/1.1", "HTTP/2", "gRPC", "Multiple"],
  "primaryUseCase": "Author high-level API definitions in a TypeScript-like DSL and emit OpenAPI, JSON Schema, Protobuf, and Azure SDK sources from a single source of truth.",
  "specificationUrl": "https://typespec.io/docs/language-basics/overview",
  "documentationUrl": "https://typespec.io/docs",
  "repositoryUrl": "https://github.com/microsoft/typespec",
  "tags": ["TypeSpec", "Microsoft", "IDL", "Specification Language"],
  "status": "active",
  "emits": ["OpenAPI 3.0", "OpenAPI 3.1", "JSON Schema", "Protobuf"]
}

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/typespec-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.