REST API website screenshot

REST API

Representational State Transfer (REST) is an architectural style for designing networked applications using standard HTTP methods and stateless communication between client and server. REST APIs define how client and server applications communicate over the web using GET, POST, PUT, DELETE, and PATCH methods against resource-oriented URLs. REST is the dominant API paradigm, used by 89% of organisations as their primary API format. This index covers the REST API landscape including specifications, tools, frameworks, best practices, and educational resources.

REST API is profiled on the APIs.io network. Tagged areas include Architecture, HTTP, Web Services, REST, and API Design.

The REST API catalog on APIs.io includes 1 JSON-LD context.

14.8/100 minimal ▬ flat Agent 0/100 human only Full breakdown ↓
scored 2026-07-27 · rubric v0.5
0 APIs
ArchitectureHTTPWeb ServicesRESTAPI Design

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 14.8/100 · minimal
Contract Quality 5.2 / 25
Developer Ergonomics 1.3 / 20
Commercial Clarity 0.0 / 20
Operational Transparency 0.0 / 13
Governance 1.6 / 12
Discoverability 6.8 / 10
Agent readiness — 0/100 · human only
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/rest-api: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Rest Api Context

5 classes · 13 properties

JSON-LD

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Rest Api Domain Security

TLSv1.3 · DNSSEC · DMARC

SECURITY

Resources

Documentation 2

Reference material describing how the API behaves

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Access & Security 1

Authentication, authorization, and security posture

Company 1

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: rest-api
name: REST API
description: Representational State Transfer (REST) is an architectural style for designing networked applications using standard
  HTTP methods and stateless communication between client and server. REST APIs define how client and server applications
  communicate over the web using GET, POST, PUT, DELETE, and PATCH methods against resource-oriented URLs. REST is the dominant
  API paradigm, used by 89% of organisations as their primary API format. This index covers the REST API landscape including
  specifications, tools, frameworks, best practices, and educational resources.
type: Index
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/rest-api.png
tags:
- Architecture
- HTTP
- Web Services
- REST
- API Design
url: https://raw.githubusercontent.com/api-evangelist/rest-api/refs/heads/main/apis.yml
created: '2025-01-01'
modified: '2026-05-02'
specificationVersion: '0.19'
apis: []
common:
- type: DomainSecurity
  url: security/rest-api-domain-security.yml
- type: Website
  url: https://restfulapi.net
- type: Reference
  url: https://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm
- type: Guide
  url: https://www.freecodecamp.org/news/build-consume-and-document-a-rest-api/
- type: Vocabulary
  url: https://raw.githubusercontent.com/api-evangelist/rest-api/refs/heads/main/vocabulary/rest-api-vocabulary.yml
- type: JSONLDContext
  url: https://raw.githubusercontent.com/api-evangelist/rest-api/refs/heads/main/json-ld/rest-api-context.jsonld
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com