{
  "openapi": "3.1.0",
  "info": {
    "title": "Bluedoor Gas Prices API",
    "version": "1.0.0",
    "description": "REST API for normalized US gas station fuel prices from first-party public sources."
  },
  "servers": [
    {
      "url": "https://api.bluedoor.sh/gas-prices"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "summary": "Service health",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "LLM-readable API map",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/meta": {
      "get": {
        "summary": "Dataset metadata and source health",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/usage": {
      "get": {
        "summary": "Current caller identity and rate-limit state",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/auth/otp": {
      "post": {
        "summary": "Request email verification code",
        "responses": {
          "202": {
            "description": "Accepted"
          }
        }
      }
    },
    "/v1/auth/verify": {
      "post": {
        "summary": "Verify code and mint API key",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/auth/limits/requests": {
      "post": {
        "summary": "Request higher rate limits",
        "responses": {
          "202": {
            "description": "Accepted"
          }
        }
      }
    },
    "/v1/chains": {
      "get": {
        "summary": "List supported chains",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/chains/{slug}": {
      "get": {
        "summary": "Get one chain",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/stations": {
      "get": {
        "summary": "Search station snapshots",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/stations/{id}": {
      "get": {
        "summary": "Get one station",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/prices": {
      "get": {
        "summary": "Search flattened price points",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/nearby": {
      "get": {
        "summary": "Find stations near a coordinate",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/search": {
      "get": {
        "summary": "Cross-entity text search",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/coverage": {
      "get": {
        "summary": "Coverage summary",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/coverage/states": {
      "get": {
        "summary": "State coverage",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/sources": {
      "get": {
        "summary": "Adapter sync results",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/schema": {
      "get": {
        "summary": "Dataset schema",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}