Plant Varieties

Plant varieties are an essential part of Verdantly — they are the plants that you would find growing in a typical garden. On this page, we’ll dive into the different plant variety endpoints you can use to manage plant varieties programmatically. We'll look at how to query plant varieties.

The plant varieties model

The plant varieties model contains all the information about different commercial and garden cultivars.

Properties

  • Name
    id
    Type
    string
    Description

    Unique identifier for the plant record (UUID).

  • Name
    name
    Type
    string
    Description

    Name of the plant. Indexed for search.

  • Name
    category
    Type
    string
    Description

    Broad category or grouping (e.g., "Vegetable," "Fruit," "Herb").

  • Name
    type
    Type
    string
    Description

    More specific type of plant (e.g., "Tomato," "Rose").

  • Name
    subType
    Type
    string
    Description

    Subclassification of the type, if any (e.g., "Cherry Tomato").

  • Name
    description
    Type
    string
    Description

    General description or overview of the plant.

  • Name
    climateZone
    Type
    string
    Description

    Climate zone or region where the plant thrives (e.g., "Tropical," "Temperate").

  • Name
    minGrowingZone
    Type
    number
    Description

    Minimum USDA zone for successful growth (e.g., 3).

  • Name
    maxGrowingZone
    Type
    number
    Description

    Maximum USDA zone for successful growth (e.g., 9).

  • Name
    sunlightRequirement
    Type
    string
    Description

    Recommended sunlight exposure (e.g., "Full Sun," "Partial Shade").

  • Name
    waterRequirement
    Type
    string
    Description

    Ideal watering needs (e.g., "Moderate," "Frequent").

  • Name
    soilPreference
    Type
    string
    Description

    Preferred soil type (e.g., "Loamy," "Well-drained").

  • Name
    growthPeriod
    Type
    string
    Description

    Times or seasons of active growth (e.g., "Spring to Fall").

  • Name
    growthType
    Type
    string
    Description

    Nature of growth (e.g., "Climber," "Bush").

  • Name
    avgFirstBloomDate
    Type
    string
    Description

    Average date or period when the plant produces its first bloom.

  • Name
    firstHarvestDate
    Type
    string
    Description

    Estimated date or time range for initial harvest, if applicable.

  • Name
    lastHarvestDate
    Type
    string
    Description

    Estimated date or time range for final harvest, if applicable.

  • Name
    matureHeight
    Type
    number
    Description

    Approximate mature height in inches.

  • Name
    matureWidth
    Type
    number
    Description

    Approximate mature width or spread in inches.

  • Name
    careInstructions
    Type
    string
    Description

    General guidelines for ongoing plant care and maintenance.

  • Name
    commonUses
    Type
    string
    Description

    Typical applications or uses (e.g., culinary, ornamental).

  • Name
    spacingRequirement
    Type
    string
    Description

    Recommended distance between plants for optimal growth.

  • Name
    pestAndDiseaseRisks
    Type
    string
    Description

    Known pests or diseases to watch out for.

  • Name
    preferredTemperature
    Type
    string
    Description

    Ideal temperature range for this plant’s growth.

  • Name
    plantingInstructions
    Type
    object
    Description

    JSON object with indoor start, outdoor transplant, or direct sow guidance.

  • Name
    pruningInstructions
    Type
    string
    Description

    Recommended pruning techniques and best practices.

  • Name
    harvestingInstructions
    Type
    string
    Description

    Guidance on when and how to harvest for best results.

  • Name
    highlights
    Type
    string
    Description

    Notable features or benefits (e.g., drought tolerant, pollinator-friendly).

  • Name
    history
    Type
    string
    Description

    Historical or cultural background information, if relevant.

GET/v1/plants/varieties/name

Search plant varieties by name

This endpoint allows you to search for plant varieties by name. By default, 10 items will be returned per page. The name has full fuzzy search capabilities, so you can search for partial names or misspelled names.

Required attributes

  • Name
    q
    Type
    string
    Description

    Query string to search for plant varieties by name.

  • Name
    page
    Type
    integer
    Description

    Limit the number of items returned.

Request

GET
/v1/plants/varieties/name
curl -G https://verdantly-gardening-api.p.rapidapi.com/v1/plants/varieties/name \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}" \

Response

{
  "data": [
    {
     "id": "fe039c34-ef51-409c-a238-b9c30f4bbb92",
     "mappingId": "613a1110-d758-4426-95db-172d0a225911",
     "category": "vegetable",
     "name": "Abraham Lincoln Tomato",
     "type": "tomato",
     "subtype": "slicer tomato",
     "description": "A deep red, juicy heirloom known for its rich, sweet flavor.",
     "growingRequirements": {
       "minGrowingZone": 4,
       "maxGrowingZone": 10,
       "growingZoneRange": "4-10",
       "careInstructions": "Provide strong trellising to support heavy fruit production.",
       "soilPreference": "Loamy, well-draining soil with added compost",
       "sunlightRequirement": "Full sun",
       "waterRequirement": "Moderate",
       "preferredTemperature": "70-85°F",
       "spacingRequirement": "18-24 inches apart"
     },
     "growthDetails": {
       "growthPeriod": "Annual",
       "growthType": "Vine",
       "matureHeight": 72,
       "matureWidth": 36
     },
     "lifecycleMilestones": {
       "avgFirstBloomDate": "Mid-spring",
       "firstHarvestDate": "Mid-summer",
       "lastHarvestDate": "Late summer"
     },
     "careInstructions": {
       "plantingInstructions": {
         "startIndoors": "Yes, 6-8 weeks before last frost.",
         "transplantOutdoors": "After last frost date.",
         "directSow": "Not recommended."
       },
       "pruningInstructions": "Prune regularly for better airflow and disease prevention.",
       "harvestingInstructions": "Harvest when fruit turns deep red and slightly soft."
     },
     "commonUses": "Fresh eating, slicing, cooking",
     "pestAndDiseaseRisks": "Blight, aphids, nematodes",
     "highlights": "Juicy, sweet, historic heirloom.",
     "history": "Abraham Lincoln tomatoes date back to the late 1920s and were one of the first popular commercial tomato varieties. Unlike modern hybrids, they offer a true old-fashioned tomato taste with a balance of sweetness and acidity. Their ability to grow in a variety of climates makes them a reliable choice for gardeners. Today, they remain one of the most prized heirloom slicers in cultivation."
    },

    // more items...
  ],
  "meta": {
    "totalCount": 198,
    "pages": 20,
    "page": 1,
    "perPage": 10
  }
}
GET/v1/plants/varieties/filter

Search plant varieties with filter

This endpoint allows you to search for plant varieties with a combination of different filters. By default, 10 items will be returned per page.

Required attributes

  • Name
    page
    Type
    integer
    Description

    Limit the number of items returned.

Optional attributes

  • Name
    category
    Type
    enum
    Description

    Filter plant varieties by category. Use the categories endpoint to get a list of all available categories.

  • Name
    type
    Type
    string
    Description

    Filter plant varieties by type. Use the types by category endpoint to get a list of all available types for a category.

  • Name
    subtype
    Type
    string
    Description

    Filter plant varieties by subtype. Use the subtypes by type endpoint to get a list of all available subtypes for a type.

  • Name
    growingZone
    Type
    string
    Description

    Filter plant varieties by growing zone.

  • Name
    sunlightRequirement
    Type
    string
    Description

    Filter plant varieties by sunlight requirement.

  • Name
    soilPreference
    Type
    string
    Description

    Filter plant varieties by soil preference.

  • Name
    growthPeriod
    Type
    string
    Description

    Filter plant varieties by growth period.

  • Name
    growthType
    Type
    string
    Description

    Filter plant varieties by growth type.

  • Name
    pestAndDiseaseRisks
    Type
    string
    Description

    Filter plant varieties by pest and disease risks.

  • Name
    minHeight
    Type
    integer
    Description

    Filter plant varieties by minimum height.

  • Name
    maxHeight
    Type
    integer
    Description

    Filter plant varieties by maximum height.

  • Name
    commonUses
    Type
    string
    Description

    Filter plant varieties by common uses.

  • Name
    preferredTemperature
    Type
    string
    Description

    Filter plant varieties by preferred temperature.

  • Name
    waterRequirement
    Type
    string
    Description

    Filter plant varieties by water requirement.

  • Name
    highlights
    Type
    string
    Description

    Filter plant varieties by highlights.

Request

GET
/v1/v1/plants/varieties/filter
curl -G https://verdantly-gardening-api.p.rapidapi.com/v1/plants/varieties/filter \
  -H "X-RapidAPI-Host: verdantly-gardening-api.p.rapidapi.com" \
  -H "X-RapidAPI-Key: {apiKey}" \

Response

{
  "data": [
    {
      "id": "fe039c34-ef51-409c-a238-b9c30f4bbb92",
      "mappingId": "613a1110-d758-4426-95db-172d0a225911",
      "category": "vegetable",
      "name": "Abraham Lincoln Tomato",
      "type": "tomato",
      "subtype": "slicer tomato",
      "description": "A deep red, juicy heirloom known for its rich, sweet flavor.",
      "growingRequirements": {
        "minGrowingZone": 4,
        "maxGrowingZone": 10,
        "growingZoneRange": "4-10",
        "careInstructions": "Provide strong trellising to support heavy fruit production.",
        "soilPreference": "Loamy, well-draining soil with added compost",
        "sunlightRequirement": "Full sun",
        "waterRequirement": "Moderate",
        "preferredTemperature": "70-85°F",
        "spacingRequirement": "18-24 inches apart"
      },
      "growthDetails": {
        "growthPeriod": "Annual",
        "growthType": "Vine",
        "matureHeight": 72,
        "matureWidth": 36
      },
      "lifecycleMilestones": {
        "avgFirstBloomDate": "Mid-spring",
        "firstHarvestDate": "Mid-summer",
        "lastHarvestDate": "Late summer"
      },
      "careInstructions": {
        "plantingInstructions": {
          "startIndoors": "Yes, 6-8 weeks before last frost.",
          "transplantOutdoors": "After last frost date.",
          "directSow": "Not recommended."
        },
        "pruningInstructions": "Prune regularly for better airflow and disease prevention.",
        "harvestingInstructions": "Harvest when fruit turns deep red and slightly soft."
      },
      "commonUses": "Fresh eating, slicing, cooking",
      "pestAndDiseaseRisks": "Blight, aphids, nematodes",
      "highlights": "Juicy, sweet, historic heirloom.",
      "history": "Abraham Lincoln tomatoes date back to the late 1920s and were one of the first popular commercial tomato varieties. Unlike modern hybrids, they offer a true old-fashioned tomato taste with a balance of sweetness and acidity. Their ability to grow in a variety of climates makes them a reliable choice for gardeners. Today, they remain one of the most prized heirloom slicers in cultivation."
    },

    // more items...
  ],
  "meta": {
    "totalCount": 198,
    "pages": 20,
    "page": 1,
    "perPage": 10
  }
}

Was this page helpful?