A Machine-Readable Index for Your APIs

APIs.json is an open source format that API providers use to describe their API operations — like a sitemap.xml for APIs. It indexes OpenAPI specs, JSON Schema, documentation, pricing, terms of service, and more, making your APIs discoverable by APIs.io and other tools.

Latest Version — View diff from 0.19

APIs.json v0.20 — Current Stable What changed →

All Versions

0.20 Spec Diff 0.19 Spec Diff 0.18 Spec Diff 0.17 Spec Diff 0.16 Spec Diff 0.15 Spec Diff 0.14 Spec Diff 0.13 Spec Diff 0.12 Spec Diff 0.11 Spec

Example APIs.json

name: Acme Developer API
description: The Acme platform API for managing accounts, resources, and integrations.
url: https://api.acme.com/apis.json
created: "2024-01-01"
modified: "2026-05-01"
specificationVersion: "0.20"
tags:
  - acme
  - accounts
  - platform
maintainers:
  - FN: Acme Engineering
    email: [email protected]
    url: https://developers.acme.com
common:
  - type: Authentication
    url: https://developers.acme.com/authentication
  - type: TermsOfService
    url: https://acme.com/terms
  - type: PrivacyPolicy
    url: https://acme.com/privacy
  - type: StatusPage
    url: https://status.acme.com
apis:
  - name: Accounts API
    description: Create and manage Acme accounts, users, and permissions.
    humanURL: https://developers.acme.com/accounts
    baseURL: https://api.acme.com/v2/accounts
    image: https://acme.com/images/api-icon.png
    tags:
      - accounts
      - users
      - permissions
    properties:
      - type: Documentation
        url: https://developers.acme.com/accounts/docs
      - type: OpenAPI
        url: https://developers.acme.com/specs/accounts-v2.yaml
      - type: GettingStarted
        url: https://developers.acme.com/getting-started
      - type: Pricing
        url: https://acme.com/pricing
      - type: ChangeLog
        url: https://developers.acme.com/changelog
      - type: RoadMap
        url: https://developers.acme.com/roadmap
      - type: Support
        url: https://github.com/acme/api/issues
  - name: Payments API
    description: Process payments, manage subscriptions, and handle refunds.
    humanURL: https://developers.acme.com/payments
    baseURL: https://api.acme.com/v2/payments
    image: https://acme.com/images/api-icon.png
    tags:
      - payments
      - billing
      - subscriptions
    properties:
      - type: Documentation
        url: https://developers.acme.com/payments/docs
      - type: OpenAPI
        url: https://developers.acme.com/specs/payments-v2.yaml
      - type: PostmanCollection
        url: https://www.postman.com/acme/workspace/payments-api
      - type: Webhooks
        url: https://developers.acme.com/payments/webhooks
      - type: SDKs
        url: https://developers.acme.com/sdks

Who Is Using APIs.json?