APIs.json

APIs.json Specification

The APIs.json specification defines a machine-readable JSON or YAML format for describing API operations. Unlike OpenAPI which describes the technical interface of a single API, APIs.json describes the surrounding operations of one or more APIs — documentation, authentication, pricing, terms of service, support, and other properties. Created by Kin Lane and Steven Willmott in May 2014, the specification is maintained as an informal IETF draft at apisjson.org. The current stable version is 0.19, published November 6, 2024. APIs.json files are placed at the domain root as /apis.json or /apis.yml for automated discovery by robots and search engines.

GitHub

Documentation

📖
Documentation
https://apisjson.org/schema/

Schemas & Data

📊
JSONSchema
Schema v0.19
📊
JSONSchema
Schema v0.18
📊
JSONSchema
Schema v0.17
📊
JSONSchema
Schema v0.20 (Draft)

Other Resources

🔗
Specification
https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/spec/apisjson_0.19.txt

API entry from apis.yml

apis.yml Raw ↑ 
aid: apis-json:apis-json-specification
name: APIs.json Specification
description: The APIs.json specification defines a machine-readable JSON or YAML format for describing
  API operations. Unlike OpenAPI which describes the technical interface of a single API, APIs.json describes
  the surrounding operations of one or more APIs — documentation, authentication, pricing, terms of service,
  support, and other properties. Created by Kin Lane and Steven Willmott in May 2014, the specification
  is maintained as an informal IETF draft at apisjson.org. The current stable version is 0.19, published
  November 6, 2024. APIs.json files are placed at the domain root as /apis.json or /apis.yml for automated
  discovery by robots and search engines.
humanURL: https://apisjson.org
tags:
- API Description
- API Discovery
- API Operations
- Machine Readable
- Specification
- Standard
properties:
- type: Documentation
  url: https://apisjson.org/schema/
- type: Specification
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/spec/apisjson_0.19.txt
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.19.yaml
  title: Schema v0.19
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.18.yaml
  title: Schema v0.18
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.17.yaml
  title: Schema v0.17
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.20.yaml
  title: Schema v0.20 (Draft)