US State Gas Price Details (by State Code)

{
  "type": "object",
  "required": [
    "state_code"
  ],
  "properties": {
    "state_code": {
      "type": "string",
      "description": "Two-letter US state code (e.g. TX, CA, NY, FL). All 50 states and DC are supported."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "prices": {
          "type": "object",
          "properties": {
            "Diesel": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "Premium": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "Regular": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "Mid-Grade": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            }
          },
          "description": "Average price per gallon by fuel grade. Observed keys: 'Regular', 'Mid-Grade', 'Premium', 'Diesel' -- the vendor's endpoint description states this covers all fuel grades, and all four appeared on the one real fixture observed (Texas).",
          "additionalProperties": true
        },
        "state_code": {
          "type": "string",
          "description": "Echoes the requested code, e.g. 'TX'."
        },
        "state_name": {
          "type": "string",
          "description": "Full state name, e.g. 'Texas'."
        },
        "highest_recorded": {
          "type": "object",
          "properties": {
            "Diesel": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "e.g. '9/9/26' (M/D/YY)."
                },
                "price": {
                  "type": "string",
                  "description": "Numeric string, e.g. '5.5368'."
                }
              },
              "additionalProperties": true
            },
            "Regular Unleaded": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "e.g. '6/15/22' (M/D/YY)."
                },
                "price": {
                  "type": "string",
                  "description": "Numeric string, e.g. '4.6949'."
                }
              },
              "additionalProperties": true
            }
          },
          "description": "All-time highest recorded price on file, per fuel grade, with the date it was recorded. Only 'Regular Unleaded' and 'Diesel' were present on the one real fixture observed (Texas) -- note this grade naming does NOT match `prices`' own grade keys ('Regular Unleaded' here vs. 'Regular' above), and whether 'Mid-Grade' /'Premium' entries ever appear here for other states is unconfirmed. `price` is a numeric string here (e.g. '4.6949'), unlike the plain numbers under `prices`.",
          "additionalProperties": true
        }
      },
      "description": "Absent entirely for an unrecognized state_code (e.g. 'ZZ', observed) -- that case returns output: null and bills $0, shaping down to an empty object rather than an error. Present with the fields below only for a recognized two-letter state code.",
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on the real populated call observed (a valid state code)."
    }
  },
  "description": "The state price record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}