{
  "openapi": "3.0.3",
  "info": {
    "title": "Agent Native Offers \u2014 AUDIE Score API",
    "version": "1.0.0",
    "description": "Read-only API for Agent Native Offer Audit scores. Static JSON, no authentication, CC BY-NC 4.0.",
    "contact": {
      "email": "aionestopshop25@gmail.com"
    }
  },
  "servers": [
    {
      "url": "https://agentnativeoffers.com"
    }
  ],
  "paths": {
    "/api/audits/index.json": {
      "get": {
        "operationId": "listAudits",
        "summary": "List all audited companies with scores and pillar breakdown",
        "responses": {
          "200": {
            "description": "Leaderboard index",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Index"
                }
              }
            }
          }
        }
      }
    },
    "/api/audits/{slug}.json": {
      "get": {
        "operationId": "getAudit",
        "summary": "Full audit for one company (pillars, 20 criteria with evidence, gaps, action plan)",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "composio"
          }
        ],
        "responses": {
          "200": {
            "description": "Full audit record",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Audit"
                }
              }
            }
          },
          "404": {
            "description": "Unknown slug \u2014 see index.json for valid slugs"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Index": {
        "type": "object",
        "properties": {
          "count": {
            "type": "integer"
          },
          "rubric_version": {
            "type": "string"
          },
          "audits": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "rank": {
                  "type": "integer"
                },
                "company": {
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "overall_score": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 100
                },
                "tier": {
                  "type": "string",
                  "enum": [
                    "Agent-Ready",
                    "Emerging",
                    "Human-Dependent",
                    "Agent-Invisible"
                  ]
                },
                "pillar_scores": {
                  "type": "object"
                },
                "detail_json": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "Audit": {
        "type": "object",
        "properties": {
          "company": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "audit_date": {
            "type": "string",
            "format": "date"
          },
          "overall_score": {
            "type": "integer"
          },
          "tier": {
            "type": "string"
          },
          "pillars": {
            "type": "object"
          },
          "criteria": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "score": {
                  "type": "integer",
                  "maximum": 5
                },
                "evidence": {
                  "type": "string"
                }
              }
            }
          },
          "strongest_signals": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "critical_gaps": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "priority_actions": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "executive_summary": {
            "type": "string"
          }
        }
      }
    }
  }
}