{
  "openapi": "3.1.1",
  "info": {
    "title": "NetFee Creator Platform Fee Data API",
    "version": "2026.08.11",
    "description": "Read-only public access to the versioned Creator Platform Fee Dataset. Each record includes a condition, exclusions, official source URL, verification date, and dataset version."
  },
  "servers": [
    {
      "url": "https://fees.atomcoming.com",
      "description": "Public production endpoint"
    }
  ],
  "paths": {
    "/data/creator-platform-fees-2026-08.json": {
      "get": {
        "operationId": "getCreatorPlatformFeeDataset",
        "summary": "Get the complete Creator Platform Fee Dataset",
        "responses": {
          "200": {
            "description": "The public versioned dataset.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreatorPlatformFeeDataset"
                }
              }
            }
          }
        }
      }
    },
    "/data/datapackage.json": {
      "get": {
        "operationId": "getCreatorPlatformFeeDataPackage",
        "summary": "Get resource and field metadata for the downloadable dataset",
        "responses": {
          "200": {
            "description": "A Data Package descriptor for the CSV and JSON downloads.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CreatorPlatformFeeDataset": {
        "type": "object",
        "required": ["version", "verified_on", "license", "records"],
        "properties": {
          "version": { "type": "string", "example": "2026.08.09" },
          "verified_on": { "type": "string", "format": "date", "example": "2026-08-09" },
          "license": { "type": "string", "format": "uri", "example": "https://creativecommons.org/licenses/by/4.0/" },
          "records": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/CreatorPlatformFeeRecord" }
          }
        }
      },
      "CreatorPlatformFeeRecord": {
        "type": "object",
        "required": ["platform_slug", "platform", "category", "rule_type", "channel_or_condition", "rate_min_percent", "rate_max_percent", "fixed_fee_usd", "rate_applies_to", "exclusions_or_notes", "official_source", "verified_on", "version"],
        "properties": {
          "platform_slug": { "type": "string", "enum": ["fiverr", "upwork", "gumroad", "ko-fi", "etsy", "amazon-kdp"] },
          "platform": { "type": "string" },
          "category": { "type": "string" },
          "rule_type": { "type": "string" },
          "channel_or_condition": { "type": "string" },
          "rate_min_percent": { "type": ["number", "null"] },
          "rate_max_percent": { "type": ["number", "null"] },
          "fixed_fee_usd": { "type": ["number", "null"] },
          "rate_applies_to": { "type": "string" },
          "exclusions_or_notes": { "type": "string" },
          "official_source": { "type": "string", "format": "uri" },
          "verified_on": { "type": "string", "format": "date" },
          "version": { "type": "string" }
        }
      }
    }
  }
}