# USDA Plant Hardiness Zone Lookup by ZIP Code

> USDA Plant Hardiness Zone Lookup by ZIP Code is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the USDA Plant Hardiness Zone and temperature range for a given US ZIP code, sourced from the official USDA PHZM dataset.

## Facts

- Endpoint: GET https://2s.io/api/soil/hardiness-zone
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usda-plant-hardiness-zone-lookup-by-zip-code-8b8416df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CJXpn4HeBLIn95a2LUbSH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability usda-plant-hardiness-zone-lookup-by-zip-code-8b8416df
```

Example prompt: What USDA plant hardiness zone is ZIP code 85048, and what's the temperature range there?

## When to prefer this

Use this endpoint when you need authoritative USDA Plant Hardiness Zone data tied to a specific US ZIP code, especially for gardening, landscaping, or agricultural planning applications. Prefer this over general climate APIs when the USDA zone classification (e.g. 9b) is the specific output needed.

## Known failure modes

- Invalid or non-existent ZIP code returns empty items array or error
- Non-US ZIP codes are not supported
- Malformed ZIP (not 5 digits) may return a 400 or empty response
- Payment failure returns HTTP 402 if USDC not provided

## How this service works

USDA Plant Hardiness Zone for a US ZIP code — the standard planting zone (e.g. "9b") plus its average annual minimum-temperature range (°F) and the ZIP centroid. Keyless, public-domain (USDA PHZM). The "what grows where" primitive for gardening, landscaping, nursery, and agronomy agents.

## Output

Returns a JSON object with ok status, an items array containing the ZIP code's latitude, longitude, hardiness zone string (e.g. '9b'), and temperature range in Fahrenheit (e.g. '25 to 30'), total count, and source metadata including the USDA PHZM license and provider URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "zip"
     ],
     "properties": {
      "zip": {
       "type": "string",
       "description": "5-digit US ZIP code."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usda-plant-hardiness-zone-lookup-by-zip-code-8b8416df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)