{
  "openapi": "3.0.3",
  "info": {
    "title": "Ez-Kosher API",
    "description": "Public API providing comprehensive, machine-readable dataset for verified kosher restaurants, groceries, bakeries, cafes, and delivery services in New York.",
    "version": "1.0.0",
    "contact": {
      "name": "Ez-Kosher Team",
      "url": "https://ez-kosher.com/"
    }
  },
  "servers": [
    {
      "url": "https://ez-kosher.com",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/data.json": {
      "get": {
        "summary": "Get all kosher establishments",
        "description": "Returns the complete JSON dataset of all verified kosher establishments with location, category, contact information, and kosher details.",
        "operationId": "getEstablishments",
        "responses": {
          "200": {
            "description": "Successful response containing array of kosher establishment objects",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Establishment"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/certifications.json": {
      "get": {
        "summary": "Get kosher certifying agencies",
        "description": "Returns a dictionary mapping kosher certification acronyms to their full organizational names and details.",
        "operationId": "getCertifications",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Get full Markdown directory dataset",
        "description": "Returns the full dataset formatted in clean Markdown for AI context window processing.",
        "operationId": "getLlmsFull",
        "responses": {
          "200": {
            "description": "Markdown content",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Get LLM index file",
        "description": "Returns structured overview and link index per the llms.txt standard.",
        "operationId": "getLlmsTxt",
        "responses": {
          "200": {
            "description": "Markdown summary",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Establishment": {
        "type": "object",
        "required": [
          "id",
          "name",
          "type",
          "location",
          "kosherDetails"
        ],
        "properties": {
          "id": {
            "type": "string",
            "example": "est-001"
          },
          "name": {
            "type": "string",
            "example": "Carlos & Gabby's"
          },
          "type": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Restaurant",
                "Grocery",
                "Delivery",
                "Bakery",
                "Cafe"
              ]
            }
          },
          "description": {
            "type": "string",
            "example": "Mexican kosher restaurant serving tacos, burritos, and burgers."
          },
          "location": {
            "type": "object",
            "required": [
              "address",
              "city",
              "state",
              "zip",
              "lat",
              "lng"
            ],
            "properties": {
              "address": { "type": "string" },
              "city": { "type": "string" },
              "state": { "type": "string" },
              "zip": { "type": "string" },
              "lat": { "type": "number" },
              "lng": { "type": "number" }
            }
          },
          "contact": {
            "type": "object",
            "properties": {
              "phone": { "type": "string" },
              "website": { "type": "string" }
            }
          },
          "kosherDetails": {
            "type": "object",
            "required": [
              "certifications",
              "pasYisroel"
            ],
            "properties": {
              "certifications": {
                "type": "array",
                "items": { "type": "string" }
              },
              "meatOrDairy": {
                "type": "string",
                "enum": ["Meat", "Dairy", "Pareve"]
              },
              "pasYisroel": {
                "type": "boolean"
              }
            }
          },
          "deliveryApps": {
            "type": "array",
            "items": { "type": "string" }
          }
        }
      }
    }
  }
}