{
 "openapi": "3.1.0",
 "info": {
  "title": "RestroomTrailerHQ public directory data",
  "version": "1.0.0",
  "description": "Read-only static JSON for US luxury restroom trailer rental fleets, city pages and the cost index. No authentication. CC BY 4.0, attribution RestroomTrailerHQ. Prices are estimates, not quotes; numbers appear only where the fleet publishes or confirmed them.",
  "license": {
   "name": "CC BY 4.0",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "contact": {
   "name": "RestroomTrailerHQ",
   "url": "https://restroomtrailerhq.com/developers/"
  }
 },
 "servers": [
  {
   "url": "https://restroomtrailerhq.com"
  }
 ],
 "paths": {
  "/api/v1/index.json": {
   "get": {
    "operationId": "getIndex",
    "summary": "List all endpoints",
    "responses": {
     "200": {
      "description": "Endpoint index",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/fleets.json": {
   "get": {
    "operationId": "listFleets",
    "summary": "All listed fleets with HQ point, stall sizes, ADA flag, labelled price and published delivery terms",
    "responses": {
     "200": {
      "description": "Fleet list",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/cities.json": {
   "get": {
    "operationId": "listCities",
    "summary": "All city pages with map anchor and fleet counts",
    "responses": {
     "200": {
      "description": "City index",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/cities/{state}/{city}.json": {
   "get": {
    "operationId": "getCity",
    "summary": "Fleets serving one city plus its cost-index row",
    "parameters": [
     {
      "name": "state",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "State slug, e.g. texas"
     },
     {
      "name": "city",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "City slug from cities.json, e.g. austin-hill-country"
     }
    ],
    "responses": {
     "200": {
      "description": "City detail",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "Unknown city slug"
     }
    }
   }
  },
  "/api/v1/cost-index.json": {
   "get": {
    "operationId": "getCostIndex",
    "summary": "2026 cost index by city (weekend estimates by trailer size, verified vs unverified counts)",
    "responses": {
     "200": {
      "description": "Cost index",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/mcp": {
   "post": {
    "operationId": "mcp",
    "summary": "Remote MCP server (JSON-RPC 2.0, Streamable HTTP, stateless). Tools: search_fleets, get_cost_index. Read-only.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "JSON-RPC response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "202": {
      "description": "Notification accepted"
     }
    }
   }
  }
 }
}