API documentation

{
  "data": {
    "zip": string,               // the 5-digit ZIP you requested
    "zone": string | null,       // the ZIP's USDA hardiness zone, e.g. "8a"
    "nearestPlace": {            // nearest publishable place page, or null if none within ~200 km
      "name": string,
      "slug": string,
      "state_slug": string,
      "state_abbrev": string,
      "zone": string | null,
      "url": string,             // path to the place page, e.g. "/georgia/atlanta"
      "km": number               // distance from the ZIP centroid, in km
    } | null
  }
}

{
  "data": {
    "zip": "30303",
    "zone": "8a",
    "nearestPlace": {
      "name": "Atlanta",
      "slug": "atlanta",
      "state_slug": "georgia",
      "state_abbrev": "GA",
      "zone": "8a",
      "url": "/georgia/atlanta",
      "km": 3.201738205913127
    }
  }
}

{
  "data": {
    "zip": string,
    "zone": string | null,       // the ZIP's USDA hardiness zone
    "frostFree": boolean,        // true => no NOAA freeze station in range; frost fields are null
    "station": {                 // the NOAA station the dates come from, or null
      "id": string,
      "name": string | null,
      "km": number               // distance from the ZIP centroid to the station, in km
    } | null,
    "lastSpringFrost": {         // 32°F, 50/10/90% ISO dates carrying the current year; null when frostFree
      "p10": string, "p50": string, "p90": string
    } | null,
    "firstFallFrost": {          // 32°F; same shape; null when frostFree
      "p10": string, "p50": string, "p90": string
    } | null,
    "growingSeasonDays": number | null,  // frost-free days between the 32°F p50 anchors; null when frostFree
    "nearestPlace": { … same shape as /zones nearestPlace … } | null
  }
}

{
  "data": {
    "zip": "30303",
    "zone": "8a",
    "frostFree": false,
    "station": {
      "id": "USW00003888",
      "name": "ATLANTA FULTON CO AP",
      "km": 12.474559807084498
    },
    "lastSpringFrost": {
      "p10": "2026-04-10",
      "p50": "2026-03-24",
      "p90": "2026-03-02"
    },
    "firstFallFrost": {
      "p10": "2026-10-27",
      "p50": "2026-11-08",
      "p90": "2026-11-26"
    },
    "growingSeasonDays": 229,
    "nearestPlace": {
      "name": "Atlanta",
      "slug": "atlanta",
      "state_slug": "georgia",
      "state_abbrev": "GA",
      "zone": "8a",
      "url": "/georgia/atlanta",
      "km": 3.201738205913127
    }
  }
}

{
  "data": [
    {
      "slug": string,
      "name": string,
      "type": string | null,        // "vegetable" | "herb"
      "hardiness": string | null,   // "tender" | "half-hardy" | "hardy" | "very-hardy"
      "days_to_maturity": [min, max] | null,   // days from transplant (or direct sow)
      // Week-range offsets from the local frost dates (50% probability, 32°F). null = action N/A.
      "start_indoors_weeks_before_last_frost": [min, max] | null,       // weeks BEFORE last spring frost
      "transplant_weeks_relative_to_last_frost": [min, max] | null,     // relative to last frost; negative = before
      "direct_sow_weeks_relative_to_last_frost": [min, max] | null,     // relative to last frost; negative = before
      "fall_sow_weeks_before_first_frost": [min, max] | null            // weeks BEFORE first fall frost
    }
  ]
}

{
  "data": [
    {
      "slug": "acorn-squash",
      "name": "Acorn Squash",
      "type": "vegetable",
      "hardiness": "tender",
      "days_to_maturity": [
        80,
        100
      ],
      "start_indoors_weeks_before_last_frost": null,
      "transplant_weeks_relative_to_last_frost": null,
      "direct_sow_weeks_relative_to_last_frost": [
        1,
        3
      ],
      "fall_sow_weeks_before_first_frost": null
    }
  ]
}