{
  "aod": "0.1",
  "provider": {
    "name": "APIs.io",
    "url": "https://apis.io",
    "portalUrl": "https://apis.io/developer"
  },
  "maturity": "self-serve",
  "account": {
    "required": false,
    "agentPolicy": "allowed",
    "prerequisites": [],
    "plans": [
      { "name": "Free", "requiredFor": "Keyless discovery — providers, APIs, tags, artifacts, and unified search at 1,000 requests/day", "url": "https://apis.io/developer" },
      { "name": "Starter", "requiredFor": "Higher rate limits (10,000 requests/day) with an API key", "url": "https://apis.io/developer" },
      { "name": "Pro", "requiredFor": "Industries, regions, and ratings resources plus 100,000 requests/day", "url": "https://apis.io/developer" },
      { "name": "Business", "requiredFor": "1,000,000 requests/day for production workloads", "url": "https://apis.io/developer" }
    ]
  },
  "verification": [],
  "registration": {
    "applicationNoun": "API key",
    "owner": "user",
    "mechanisms": [
      {
        "type": "open",
        "description": "The base tier is keyless: call the APIs.io API right now with no account, no key, no form — read-only discovery over 15,000+ APIs and 5,000+ providers. The MCP server at https://apis.io/mcp shares the same tiering.",
        "baseUrl": "https://apis.io/api/v1",
        "docsUrls": ["https://apis.io/developer"],
        "auth": "none"
      },
      {
        "type": "console-only",
        "description": "Keyed tiers (Starter/Pro/Business) are currently issued by a human: email info@apis.io. A self-serve GitHub OAuth + billing flow is built and pending deployment — this descriptor will change when it ships.",
        "docsUrls": ["https://apis.io/developer"]
      }
    ]
  },
  "authentication": {
    "methods": [
      { "id": "none", "type": "none", "bootstrap": "" },
      {
        "id": "api-key",
        "type": "header-env",
        "header": "x-api-key",
        "env": ["APIS_IO_API_KEY"],
        "bootstrap": "Email info@apis.io to request a key for a paid tier (self-serve issuance coming)."
      }
    ]
  },
  "credentials": [
    {
      "type": "api-key",
      "fields": { "api_key": "x-api-key" },
      "oneTimeDisplay": false,
      "rotation": "Contact info@apis.io to rotate or revoke."
    }
  ],
  "scopes": {
    "model": "product-tiers",
    "notes": "Tiers gate resources, not scopes: industries, regions, and ratings require Pro or Business; everything else is available keyless."
  },
  "flow": {
    "args": [],
    "steps": [
      {
        "id": "probe",
        "description": "Prove the door is open: an unauthenticated call to the service root.",
        "auth": "none",
        "request": {
          "method": "GET",
          "url": "https://apis.io/api/v1/"
        }
      }
    ],
    "outputs": {
      "service": "{steps.probe.service}"
    }
  },
  "economics": {
    "freeTier": "Keyless: 1,000 requests/day at 5 requests/second",
    "pricingUrl": "https://apis.io/developer"
  },
  "gaps": [
    "Paid-tier API keys are issued manually today (email info@apis.io); the self-serve GitHub OAuth + billing path is built but not yet deployed."
  ]
}