APIs.io

APIs.io Artifact Types API

First-class, per-type artifact collections (OpenAPI, AsyncAPI, Arazzo, Postman, JSON Schema, and more). Each path filters and normalizes one artifact type across all providers.

Documentation GitHub OpenAPI

Operations 20

GET /openapis List openapi specifications across the catalog. #

GET /asyncapis List asyncapi specifications across the catalog. #

GET /arazzo List arazzo workflows across the catalog. #

GET /postman List postman collections across the catalog. #

GET /collections List api collections across the catalog. #

GET /graphql List graphql schemas across the catalog. #

GET /json-schemas List json schema definitions across the catalog. #

GET /json-structures List json structure definitions across the catalog. #

GET /json-ld List json-ld contexts across the catalog. #

GET /rules List governance rulesets across the catalog. #

GET /examples List examples across the catalog. #

GET /finops List finops artifacts across the catalog. #

GET /plans List plans across the catalog. #

GET /rate-limits List rate limits across the catalog. #

GET /channels List AsyncAPI event channels across the catalog. #

GET /mcp List published MCP servers across the catalog. #

GET /skills List published Agent Skills across the catalog. #

GET /scopes List OAuth scope sets across the catalog. #

GET /security List security scheme definitions across the catalog. #

GET /apis-json APIs.json indexes across the catalog. #

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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 API

curl "https://apis.io/api/v1/apis/apis-io-artifact-types-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: APIs.io Artifact Types API
  description: |-
    First-class, per-type artifact collections (OpenAPI, AsyncAPI, Arazzo, Postman, JSON Schema, and more). Each path filters and normalizes one artifact type across all providers.

    This is the Artifact Types surface of the [APIs.io API](https://apis.io/api/v1) — one of 17 contracts split from the full API by tag, each documented and governed on its own. See the APIs.json index for the whole set.
  version: 1.5.0
  contact:
    name: API Evangelist
    url: https://apis.io
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
  - url: https://apis.io/api/v1
    description: Production server.
tags:
  - name: Artifact Types
    description: First-class, per-type artifact collections (OpenAPI, AsyncAPI, Arazzo, Postman, JSON Schema, and more). Each path filters and normalizes one artifact type across all providers.
paths:
  /openapis:
    get:
      operationId: listOpenapis
      tags:
        - Artifact Types
      summary: List openapi specifications across the catalog.
      description: First-class collection of openapi specifications across every provider on the network. Surfaces and normalizes the `OpenAPI` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of openapi specifications with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_openapis
  /asyncapis:
    get:
      operationId: listAsyncapis
      tags:
        - Artifact Types
      summary: List asyncapi specifications across the catalog.
      description: First-class collection of asyncapi specifications across every provider on the network. Surfaces and normalizes the `AsyncAPI` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of asyncapi specifications with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_asyncapis
  /arazzo:
    get:
      operationId: listArazzo
      tags:
        - Artifact Types
      summary: List arazzo workflows across the catalog.
      description: First-class collection of arazzo workflows across every provider on the network. Surfaces and normalizes the `Arazzo` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of arazzo workflows with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_arazzo
  /postman:
    get:
      operationId: listPostman
      tags:
        - Artifact Types
      summary: List postman collections across the catalog.
      description: First-class collection of postman collections across every provider on the network. Surfaces and normalizes the `PostmanCollection` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of postman collections with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_postman
  /collections:
    get:
      operationId: listCollections
      tags:
        - Artifact Types
      summary: List api collections across the catalog.
      description: First-class collection of api collections across every provider on the network. Surfaces and normalizes the `Collection`, `Collections` artifact types. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of api collections with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_collections
  /graphql:
    get:
      operationId: listGraphql
      tags:
        - Artifact Types
      summary: List graphql schemas across the catalog.
      description: First-class collection of graphql schemas across every provider on the network. Surfaces and normalizes the `GraphQL` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of graphql schemas with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_graphql
  /json-schemas:
    get:
      operationId: listJsonSchemas
      tags:
        - Artifact Types
      summary: List json schema definitions across the catalog.
      description: First-class collection of json schema definitions across every provider on the network. Surfaces and normalizes the `JSONSchema` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of json schema definitions with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_json_schemas
  /json-structures:
    get:
      operationId: listJsonStructures
      tags:
        - Artifact Types
      summary: List json structure definitions across the catalog.
      description: First-class collection of json structure definitions across every provider on the network. Surfaces and normalizes the `JSONStructure` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of json structure definitions with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_json_structures
  /json-ld:
    get:
      operationId: listJsonLd
      tags:
        - Artifact Types
      summary: List json-ld contexts across the catalog.
      description: First-class collection of json-ld contexts across every provider on the network. Surfaces and normalizes the `JSONLD`, `JSONLDContext` artifact types. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of json-ld contexts with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_json_ld
  /rules:
    get:
      operationId: listRules
      tags:
        - Artifact Types
      summary: List governance rulesets across the catalog.
      description: First-class collection of governance rulesets across every provider on the network. Surfaces and normalizes the `Rules`, `SpectralRules`, `SpectralRuleset`, `Spectral` artifact types. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of governance rulesets with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_rules
  /examples:
    get:
      operationId: listExamples
      tags:
        - Artifact Types
      summary: List examples across the catalog.
      description: First-class collection of examples across every provider on the network. Surfaces and normalizes the `Example`, `Examples`, `CodeExamples` artifact types. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of examples with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_examples
  /finops:
    get:
      operationId: listFinops
      tags:
        - Artifact Types
      summary: List finops artifacts across the catalog.
      description: First-class collection of finops artifacts across every provider on the network. Surfaces and normalizes the `FinOps` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of finops artifacts with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_finops
  /plans:
    get:
      operationId: listPlans
      tags:
        - Artifact Types
      summary: List plans across the catalog.
      description: First-class collection of plans across every provider on the network. Surfaces and normalizes the `Plans` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of plans with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_plans
  /rate-limits:
    get:
      operationId: listRateLimits
      tags:
        - Artifact Types
      summary: List rate limits across the catalog.
      description: First-class collection of rate limits across every provider on the network. Surfaces and normalizes the `RateLimits` artifact type. Filter by free text, provider, and tags; pass `include=content` to inline each artifact body.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of rate limits with owning API and provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
      x-tier: free
      x-mcp-tool: find_rate_limits
  /channels:
    get:
      operationId: listChannels
      x-tier: free
      x-mcp-tool: find_artifacts
      tags:
        - Artifact Types
      summary: List AsyncAPI event channels across the catalog.
      description: First-class collection of AsyncAPI event channels across every provider — the finest-grained event/streaming discovery surface. Filter by free text, provider, and tags; `include=content` inlines each channel's spec.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of event channels with owning provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
  /mcp:
    get:
      operationId: listMcpServers
      x-tier: free
      x-mcp-tool: find_artifacts
      tags:
        - Artifact Types
      summary: List published MCP servers across the catalog.
      description: First-class collection of provider MCP servers across the network. Filter by free text, provider, and tags; `include=content` inlines each server's card/manifest.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of MCP servers with owning provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
  /skills:
    get:
      operationId: listSkills
      x-tier: free
      x-mcp-tool: find_artifacts
      tags:
        - Artifact Types
      summary: List published Agent Skills across the catalog.
      description: First-class collection of provider Agent Skills across the network. Filter by free text, provider, and tags; `include=content` inlines each skill.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of Agent Skills with owning provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
  /scopes:
    get:
      operationId: listScopes
      x-tier: pro
      x-mcp-tool: find_artifacts
      security: []
      tags:
        - Artifact Types
      summary: List OAuth scope sets across the catalog.
      description: PRO — first-class collection of OAuth scope definitions across every provider. Filter by free text, provider, and tags; `include=content` inlines each scope set.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of OAuth scope sets with owning provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
        "402":
          $ref: "#/components/responses/UpgradeRequired"
  /security:
    get:
      operationId: listSecurity
      x-tier: pro
      x-mcp-tool: find_artifacts
      security: []
      tags:
        - Artifact Types
      summary: List security scheme definitions across the catalog.
      description: PRO — first-class collection of provider security/auth scheme definitions (authentication, domain security, VDP, trust center) across the network. Filter by free text, provider, and tags; `include=content` inlines each definition.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Match"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/ArtifactSort"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of security definitions with owning provider context.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ArtifactList"
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
        "402":
          $ref: "#/components/responses/UpgradeRequired"
  /apis-json:
    get:
      operationId: listApisJson
      x-tier: free
      x-mcp-tool: find_apis_json
      tags:
        - Artifact Types
      summary: APIs.json indexes across the catalog.
      description: The APIs.json self-descriptions registered by APIs in the catalog, by reference. Pass `include=content` to inline each document.
      parameters:
        - $ref: "#/components/parameters/Q"
        - $ref: "#/components/parameters/Providers"
        - $ref: "#/components/parameters/Tags"
        - $ref: "#/components/parameters/Include"
        - $ref: "#/components/parameters/Page"
        - $ref: "#/components/parameters/Limit"
      responses:
        "200":
          description: A page of APIs.json references.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
          headers:
            ratelimit-policy:
              $ref: "#/components/headers/RateLimitPolicy"
            x-ratelimit-tier:
              $ref: "#/components/headers/RateLimitTier"
            x-ratelimit-limit:
              $ref: "#/components/headers/RateLimitLimit"
            x-ratelimit-window:
              $ref: "#/components/headers/RateLimitWindow"
        "400":
          $ref: "#/components/responses/BadRequest"
      security: []
components:
  parameters:
    Limit:
      name: limit
      in: query
      description: Items per page.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 25
    Q:
      name: q
      in: query
      description: Free-text query over name and description (and tags where applicable).
      schema:
        type: string
        maxLength: 1024
    Page:
      name: page
      in: query
      description: 1-based page number.
      schema:
        type: integer
        minimum: 1
        default: 1
        maximum: 1000000
    Providers:
      name: providers
      in: query
      description: Comma-separated provi

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/apis-io/refs/heads/main/openapi/apis-io-artifact-types-api-openapi.yml

APIs.io Artifact Types API

Operations 20

Documentation

Specifications

Schemas & Data

Other Resources