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.24 — Current Stable What changed →

All Versions

0.24 Draft Spec What's New 0.23 Spec What's New 0.22 Spec What's New 0.21 Spec What's New 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/.well-known/apis.json
created: "2024-01-01"
modified: "2026-05-01"
specificationVersion: "0.24"
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
prompts:
  - type: AgentPrompt
    url: https://developers.acme.com/prompts/getting-started.md
rules:
  - type: SpectralRules
    url: https://developers.acme.com/governance/acme-rules.yaml
workflows:
  - type: Arazzo
    url: https://developers.acme.com/workflows/onboard-and-charge.yaml
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
    workflows:
      - type: Arazzo
        url: https://developers.acme.com/workflows/charge-and-refund.yaml
    prompts:
      - type: AgentPrompt
        url: https://developers.acme.com/prompts/take-a-payment.md

Who Is Using APIs.json?

156 providers publish an authoritative APIs.json — an index served on the same domain as the APIs it describes, indexing 462 APIs between them. Every link below was fetched and parsed on 2026-10-20; a 200 alone does not earn a place here.