RESTful APIs · JSON Structure

Restful Apis Resource Structure

Structure documentation for a standard RESTful API resource representation

Type: Properties: 0
ArchitectureHTTPRESTWeb ServicesOpenAPIStandardsDesign

RESTful Resource is a JSON Structure definition published by RESTful APIs.

Meta-schema:

JSON Structure

restful-apis-resource-structure.json Raw ↑
{
  "name": "RESTful Resource",
  "description": "Structure documentation for a standard RESTful API resource representation",
  "fields": [
    {
      "name": "id",
      "type": "string|integer",
      "required": true,
      "description": "Unique resource identifier"
    },
    {
      "name": "href",
      "type": "string (uri)",
      "required": false,
      "description": "Self-referencing URI (HATEOAS link)"
    },
    {
      "name": "type",
      "type": "string",
      "required": true,
      "description": "Resource type name"
    },
    {
      "name": "attributes",
      "type": "object",
      "required": false,
      "description": "Resource-specific data attributes"
    },
    {
      "name": "relationships",
      "type": "object",
      "required": false,
      "description": "Links to related resources"
    },
    {
      "name": "meta",
      "type": "object",
      "required": false,
      "description": "Metadata (timestamps, version)",
      "fields": [
        {
          "name": "createdAt",
          "type": "string (date-time)",
          "required": false
        },
        {
          "name": "updatedAt",
          "type": "string (date-time)",
          "required": false
        },
        {
          "name": "version",
          "type": "integer",
          "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-apis-resource-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.

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