openapi: 3.1.0
info:
  title: Perenual Care Maps API
  description: Perenual provides a comprehensive plant database API offering access to over 10,000+ plant species, including details on care, watering, sunlight, edibility, toxicity, pests, diseases, and care guides.
  version: '2.0'
  contact:
    name: Perenual API Support
    url: https://perenual.com/docs/api
servers:
- url: https://perenual.com/api/v2
  description: Production
security:
- apiKeyAuth: []
tags:
- name: Maps
  description: Hardiness map data
paths:
  /hardiness-map:
    get:
      operationId: getHardinessMap
      summary: Get hardiness map for species
      description: Returns hardiness map data for a plant species (Supreme tier).
      tags:
      - Maps
      parameters:
      - name: species_id
        in: query
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Success
        '401':
          description: Unauthorized
        '403':
          description: Tier required
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: key
externalDocs:
  description: Documentation
  url: https://perenual.com/docs/api