{"openapi":"3.1.0","info":{"title":"Plant Hardiness API","version":"1.0.0","description":"Work with USDA Plant Hardiness Zones: determine the hardiness zone for any location from its average annual extreme minimum temperature in Celsius or Fahrenheit (returning the zone code such as 6b, the zone number, subzone and the temperature range in both units), browse the complete reference of all 26 subzones from 1a to 13b with their temperature ranges and example regions worldwide, look up a single subzone by code, and find which common garden plants — fruits, vegetables, herbs, shrubs, trees, perennials, vines, bulbs, succulents and grasses — tolerate a given zone. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side computation (no third-party upstream), so responses are instant and always available. Ideal for gardening and plant-finder apps, AgTech and landscaping tools, nurseries and education.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hardiness-api","description":"oanor gateway"}],"tags":[{"name":"Hardiness"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/from-temp":{"get":{"operationId":"get_v1_from_temp","tags":["Hardiness"],"summary":"Zone from minimum temperature","description":"","parameters":[{"name":"min_temp_c","in":"query","required":false,"description":"Avg annual extreme min temp °C","schema":{"type":"string"},"example":"-18"},{"name":"min_temp_f","in":"query","required":false,"description":"Avg annual extreme min temp °F","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"7a","zone":7,"input":{"min_temp_c":-17.8,"min_temp_f":0},"subzone":"a","description":"Average annual extreme minimum 0°F to 5°F (-17.8°C to -15°C)","example_regions":["Washington, DC","Atlanta (cool)","Paris"],"temperature_range_c":{"max":-15,"min":-17.8},"temperature_range_f":{"max":5,"min":0}},"meta":{"timestamp":"2026-05-30T22:48:28.168Z","request_id":"c0cd0afc-d5f5-4d3a-98ec-41291a7909e6"},"status":"ok","message":"Zone computed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/plants":{"get":{"operationId":"get_v1_plants","tags":["Hardiness"],"summary":"Plants suited to a zone","description":"","parameters":[{"name":"zone","in":"query","required":false,"description":"Zone number 1..13","schema":{"type":"string"},"example":"8"},{"name":"type","in":"query","required":false,"description":"fruit|vegetable|herb|shrub|tree|perennial|vine|bulb|succulent|grass","schema":{"type":"string"},"example":"herb"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"herb","zone":8,"count":5,"plants":[{"name":"Lavender","type":"herb","max_zone":9,"min_zone":5,"hardiness_range":"zones 5–9"},{"name":"Thyme","type":"herb","max_zone":9,"min_zone":5,"hardiness_range":"zones 5–9"},{"name":"Sage","type":"herb","max_zone":10,"min_zone":5,"hardiness_range":"zones 5–10"},{"name":"Rosemary","type":"herb","max_zone":11,"min_zone":7,"hardiness_range":"zones 7–11"},{"name":"Bay Laurel","type":"herb","max_zone":11,"min_zone":8,"hardiness_range":"zones 8–11"}]},"meta":{"timestamp":"2026-05-30T22:48:28.243Z","request_id":"5d05d4a9-6a64-424e-a994-f23988733ba7"},"status":"ok","message":"Plants retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/zone":{"get":{"operationId":"get_v1_zone","tags":["Hardiness"],"summary":"Single subzone by code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Subzone code 1a..13b","schema":{"type":"string"},"example":"6b"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"6b","zone":6,"subzone":"b","description":"Average annual extreme minimum -5°F to 0°F (-20.6°C to -17.8°C)","example_regions":["St. Louis, MO","Berlin","London (cold)"],"temperature_range_c":{"max":-17.8,"min":-20.6},"temperature_range_f":{"max":0,"min":-5}},"meta":{"timestamp":"2026-05-30T22:48:28.312Z","request_id":"c19be7b1-376c-48f3-b855-0ac989f9a05c"},"status":"ok","message":"Zone retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/zones":{"get":{"operationId":"get_v1_zones","tags":["Hardiness"],"summary":"All hardiness subzones","description":"","parameters":[{"name":"zone","in":"query","required":false,"description":"Filter by zone number 1..13","schema":{"type":"string"},"example":"7"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"zones":[{"code":"7a","zone":7,"subzone":"a","description":"Average annual extreme minimum 0°F to 5°F (-17.8°C to -15°C)","example_regions":["Washington, DC","Atlanta (cool)","Paris"],"temperature_range_c":{"max":-15,"min":-17.8},"temperature_range_f":{"max":5,"min":0}},{"code":"7b","zone":7,"subzone":"b","description":"Average annual extreme minimum 5°F to 10°F (-15°C to -12.2°C)","example_regions":["Washington, DC","Atlanta (cool)","Paris"],"temperature_range_c":{"max":-12.2,"min":-15},"temperature_range_f":{"max":10,"min":5}}]},"meta":{"timestamp":"2026-05-30T22:48:28.386Z","request_id":"0e755d58-b6ee-4322-aaa6-aac63c339047"},"status":"ok","message":"Zones retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":13000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":580,"monthly_call_quota":160000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1650,"monthly_call_quota":1200000,"rps_limit":22,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4200,"monthly_call_quota":5500000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hardiness-api"}