API Style Guides · Example Payload

Aip 131 Get

RESTResource-OrientedGET

Aip 131 Get is an example object payload from API Style Guides, with 14 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

$schemaidguideleveltitlesummarycategoryrationaleappliesTosourceUrlreferencesexamplesrelatedRulestags

Example Payload

aip-131-get.json Raw ↑
{
  "$schema": "../json-schema/style-guide-rule-schema.json",
  "id": "aip-131",
  "guide": "style-guides:google-aip",
  "level": "MUST",
  "title": "Standard Methods: Get",
  "summary": "A Get method retrieves a single resource by its resource name. It maps to HTTP GET and the response body is the resource itself. There is no request body.",
  "category": "HTTP Methods",
  "rationale": "Resource-oriented design depends on every resource having a Get standard method with predictable shape so generated clients and tooling can rely on it.",
  "appliesTo": ["REST", "gRPC"],
  "sourceUrl": "https://google.aip.dev/131",
  "references": [
    {
      "url": "https://google.aip.dev/121",
      "title": "AIP-121 Resource-oriented design",
      "type": "StyleGuide"
    },
    {
      "url": "https://google.aip.dev/122",
      "title": "AIP-122 Resource names",
      "type": "StyleGuide"
    }
  ],
  "examples": [
    {
      "kind": "good",
      "language": "http",
      "snippet": "GET /v1/publishers/123/books/456 HTTP/1.1\nHost: api.example.com\nAccept: application/json"
    },
    {
      "kind": "bad",
      "language": "http",
      "snippet": "POST /v1/getBook HTTP/1.1\nContent-Type: application/json\n\n{\"name\":\"publishers/123/books/456\"}",
      "note": "Using POST and a body for a read violates the standard Get method shape."
    }
  ],
  "relatedRules": ["zalando-138"],
  "tags": ["REST", "Resource-Oriented", "GET"]
}

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/aip-131-get"
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.

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