RESTful · JSON Structure

Restful Api Description Structure

Minimal descriptor for a RESTful API, capturing identity, base URL, authentication type, maturity level, and documentation links.

Type: Properties: 0

ArchitectureHTTPWeb Services

RESTful API Description is a JSON Structure definition published by RESTful.

Meta-schema:

JSON Structure

{
  "name": "RESTful API Description",
  "description": "Minimal descriptor for a RESTful API, capturing identity, base URL, authentication type, maturity level, and documentation links.",
  "fields": [
    { "name": "id", "type": "string", "description": "Unique API identifier", "required": false },
    { "name": "name", "type": "string", "description": "Human-readable API name", "required": true },
    { "name": "description", "type": "string", "description": "What the API does and its audience", "required": false },
    { "name": "version", "type": "string", "description": "API version string", "required": false },
    { "name": "baseUrl", "type": "string", "description": "Base URL for all endpoints", "required": true },
    { "name": "documentationUrl", "type": "string", "description": "Human-readable documentation URL", "required": false },
    { "name": "specificationUrl", "type": "string", "description": "OpenAPI or other machine-readable spec URL", "required": false },
    { "name": "authentication.type", "type": "string", "description": "Auth scheme: none, apiKey, bearer, basic, oauth2, openid", "required": false },
    { "name": "maturityLevel", "type": "integer", "description": "Richardson Maturity Model level 0-3", "required": false },
    { "name": "tags", "type": "array[string]", "description": "Domain classification tags", "required": false }
  ]
}

Work with this as data

Every JSON Structure 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 json structure

4 MCP tools reach this

find_json_structuresBrowse and filter every JSON Structure 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 JSON Structure

curl "https://apis.io/api/v1/json-structures/restful-api-description-structure"

All json structure

curl "https://apis.io/api/v1/json-structures?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.