{
  "openapi": "3.1.0",
  "info": {
    "title": "Fron Research Party and Event Booking Surface Sample API",
    "version": "1.0.0",
    "description": "Free static coverage metadata sample. This is not active paid access. Preserve every evidence boundary, source qualification, legal notice, permitted use, and prohibited claim when using the data."
  },
  "servers": [
    {
      "url": "https://fronresearch.com",
      "description": "Public static sample"
    }
  ],
  "paths": {
    "/data/v1/party-event-booking-surfaces.json": {
      "get": {
        "operationId": "getPartyEventBookingSurfacesJson",
        "summary": "Download party and event booking surface coverage metadata as JSON",
        "responses": {
          "200": {
            "description": "A deterministic generated metadata descriptor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverageDescriptor"
                }
              }
            }
          }
        }
      }
    },
    "/data/v1/party-event-booking-surfaces.csv": {
      "get": {
        "operationId": "getPartyEventBookingSurfacesCsv",
        "summary": "Download one row per measure as CSV",
        "responses": {
          "200": {
            "description": "A CSV with every qualification and prohibited-claim field retained",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CoverageDescriptor": {
        "type": "object",
        "required": ["descriptorVersion", "generatedAt", "id", "evidenceNotes", "legalNotice", "permittedUses", "prohibitedClaims", "records", "sourceFiles", "summary", "title"],
        "properties": {
          "descriptorVersion": { "type": "integer" },
          "generatedAt": { "type": "string" },
          "id": { "type": "string", "const": "party-event-booking-surfaces" },
          "evidenceNotes": { "type": "array", "items": { "type": "string" } },
          "legalNotice": { "type": "string" },
          "permittedUses": { "type": "array", "items": { "type": "string" } },
          "prohibitedClaims": { "type": "array", "items": { "type": "string" } },
          "records": { "type": "array", "items": { "$ref": "#/components/schemas/ProviderRecord" } },
          "sourceFiles": { "type": "array", "items": { "type": "string" } },
          "summary": { "type": "string" },
          "title": { "type": "string" }
        }
      },
      "ProviderRecord": {
        "type": "object",
        "required": ["displayName", "provider", "providerNativeEntityType", "status", "sourceQualification", "measures"],
        "properties": {
          "displayName": { "type": "string" },
          "provider": { "type": "string" },
          "providerNativeEntityType": { "type": "string" },
          "status": { "type": "string" },
          "sourceQualification": { "type": "string" },
          "measures": { "type": "array", "items": { "$ref": "#/components/schemas/Measure" } }
        }
      },
      "Measure": {
        "type": "object",
        "required": ["boundary", "entityType", "sourceFile", "sourceField", "sourceQualification", "value"],
        "properties": {
          "boundary": { "type": "string" },
          "entityType": { "type": "string" },
          "sourceFile": { "type": "string" },
          "sourceField": { "type": "string" },
          "sourceQualification": { "type": "string" },
          "value": { "type": "number" }
        }
      }
    }
  }
}