Plant Species

As the name suggests, plant species are a core part of Verdantly — the very reason Verdantly exists is so you can have a foundational reference for identifying and organizing plant-related data. On this page, we'll dive into the different plant species endpoints you can use to manage contacts programmatically. We'll look at how to query plant species.

The plant species model

The plant species model contains information such as scientific and common names, taxonomic hierarchy (family, genus, etc.), morphological characteristics, native regions, and any pertinent growth details.

Properties

  • Name
    id
    Type
    string
    Description

    Unique identifier for the record (UUID).

  • Name
    symbol
    Type
    string
    Description

    USDA or other code symbol for the plant.

  • Name
    acceptedSymbol
    Type
    string
    Description

    The officially accepted code symbol, if different.

  • Name
    synonymSymbol
    Type
    string
    Description

    Alternate or synonymous code symbol.

  • Name
    commonName
    Type
    string
    Description

    Common or colloquial name of the plant.

  • Name
    scientificName
    Type
    string
    Description

    Formal scientific (Latin) name of the plant.

  • Name
    hybridGenusIndicator
    Type
    string
    Description

    Indicates if the genus name is a hybrid.

  • Name
    hybridSpeciesIndicator
    Type
    string
    Description

    Indicates if the species name is a hybrid.

  • Name
    species
    Type
    string
    Description

    The species portion of the scientific name.

  • Name
    subspeciesPrefix
    Type
    string
    Description

    The prefix used for subspecies (e.g., "subsp.").

  • Name
    hybridSubspeciesIndicator
    Type
    string
    Description

    Indicates if the subspecies is a hybrid.

  • Name
    subspecies
    Type
    string
    Description

    The subspecies portion of the scientific name.

  • Name
    varietyPrefix
    Type
    string
    Description

    The prefix used for variety (e.g., "var.").

  • Name
    hybridVarietyIndicator
    Type
    string
    Description

    Indicates if the variety is a hybrid.

  • Name
    variety
    Type
    string
    Description

    The variety portion of the scientific name.

  • Name
    subvarietyPrefix
    Type
    string
    Description

    The prefix used for a subvariety (e.g., "subvar.").

  • Name
    subvariety
    Type
    string
    Description

    The subvariety portion of the scientific name.

  • Name
    formaPrefix
    Type
    string
    Description

    The prefix used for a forma (e.g., "f.").

  • Name
    forma
    Type
    string
    Description

    The forma portion of the scientific name.

  • Name
    generaBinomialAuthor
    Type
    string
    Description

    Authorship for the binomial name (e.g., "L.").

  • Name
    trinomialAuthor
    Type
    string
    Description

    Authorship for trinomial name classification.

  • Name
    quadranomialAuthor
    Type
    string
    Description

    Authorship for quadranomial name classification.

  • Name
    questionableTaxonIndicator
    Type
    string
    Description

    Flag or note indicating questionable taxonomy.

  • Name
    parents
    Type
    string
    Description

    Parent taxon or other hierarchical info, if any.

  • Name
    stateAndProvince
    Type
    string
    Description

    Combined location data (states/provinces).

  • Name
    category
    Type
    string
    Description

    General category (e.g., "Dicot," "Monocot," "Fern").

  • Name
    family
    Type
    string
    Description

    Family name for the plant.

  • Name
    familySymbol
    Type
    string
    Description

    Symbol for the family (e.g., "SOLANA").

  • Name
    familyCommonName
    Type
    string
    Description

    Common name for the family (e.g., "Potato family").

  • Name
    order
    Type
    string
    Description

    Taxonomic order of the plant.

  • Name
    subclass
    Type
    string
    Description

    Taxonomic subclass of the plant.

  • Name
    class
    Type
    string
    Description

    Taxonomic class of the plant.

  • Name
    subdivision
    Type
    string
    Description

    Subdivision within the plant kingdom.

  • Name
    division
    Type
    string
    Description

    Division within the plant kingdom.

  • Name
    superdivision
    Type
    string
    Description

    Superdivision within the plant kingdom.

  • Name
    subkingdom
    Type
    string
    Description

    Subkingdom classification.

  • Name
    kingdom
    Type
    string
    Description

    Kingdom classification (e.g., "Plantae").

  • Name
    duration
    Type
    string
    Description

    Growth duration, e.g., "Annual, Perennial."

  • Name
    growthHabit
    Type
    string
    Description

    Growth habit (e.g., "Forb/herb").

  • Name
    nativeStatus
    Type
    string
    Description

    Regions or statuses where native or introduced.

  • Name
    federalNoxiousStatus
    Type
    string
    Description

    Federal noxious weed status.

  • Name
    stateNoxiousStatus
    Type
    string
    Description

    State-level noxious weed status.

  • Name
    stateNoxiousCommonName
    Type
    string
    Description

    Common name used for state noxious listing.

  • Name
    invasive
    Type
    string
    Description

    Indicates if the plant is considered invasive.

  • Name
    federalTeStatus
    Type
    string
    Description

    Federal threatened/endangered status.

  • Name
    stateTeStatus
    Type
    string
    Description

    State threatened/endangered status.

  • Name
    stateTeCommonName
    Type
    string
    Description

    Common name used for state T/E status.

  • Name
    activeGrowthPeriod
    Type
    string
    Description

    Typical active growth period for the plant.

GET/v1/plants/species/name

Search plant species by name

This endpoint allows you to search for plant species 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.

Optional attributes

  • Name
    page
    Type
    integer
    Description

    Limit the number of items returned.

Request

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

Response

{
  "data": [
    {
        "id": "0c55e422-1248-4219-9c49-857b16a902d8",
        "symbol": "RIAL2",
        "acceptedSymbol": "RIAL2",
        "synonymSymbol": null,
        "commonName": "alpine currant",
        "scientificName": "Ribes alpinum L.",
        "hybridGenusIndicator": null,
        "hybridSpeciesIndicator": null,
        "species": "alpinum",
        "subspeciesPrefix": null,
        "hybridSubspeciesIndicator": null,
        "subspecies": null,
        "varietyPrefix": null,
        "hybridVarietyIndicator": null,
        "variety": null,
        "subvarietyPrefix": null,
        "subvariety": null,
        "formaPrefix": null,
        "forma": null,
        "generaBinomialAuthor": "L.",
        "trinomialAuthor": null,
        "quadranomialAuthor": null,
        "questionableTaxonIndicator": null,
        "parents": null,
        "stateAndProvince": "USA (MI)",
        "category": "Dicot",
        "family": "Grossulariaceae",
        "familySymbol": "GROSSU",
        "familyCommonName": "Currant family",
        "order": "Rosales",
        "subclass": "Rosidae",
        "class": "Magnoliopsida",
        "subdivision": null,
        "division": "Magnoliophyta",
        "superdivision": "Spermatophyta",
        "subkingdom": "Tracheobionta",
        "kingdom": "Plantae",
        "duration": "Perennial",
        "growthHabit": "Shrub",
        "nativeStatus": "L48 (I)",
        "federalNoxiousStatus": null,
        "stateNoxiousStatus": null,
        "stateNoxiousCommonName": null,
        "invasive": null,
        "federalTeStatus": null,
        "stateTeStatus": null,
        "stateTeCommonName": null,
        "activeGrowthPeriod": null
    },

    // more items...
  ],
  "meta": {
    "totalCount": 53,
    "pages": 6,
    "page": 1,
    "perPage": 10
  }
}
GET/v1/plants/species/filter

Search plant species by filter

This endpoint allows you to search for plant species 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
    symbol
    Type
    string
    Description

    Filter plant species by symbol.

  • Name
    commonName
    Type
    string
    Description

    Filter plant species by common name.

  • Name
    scientificName
    Type
    string
    Description

    Filter plant species by scientific name.

  • Name
    family
    Type
    string
    Description

    Filter plant species by family.

  • Name
    category
    Type
    string
    Description

    Filter plant species by category.

  • Name
    order
    Type
    string
    Description

    Filter plant species by order.

Request

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

Response

{
  "data": [
    {
      "id": "2fd0934d-0753-4736-909a-fca5c4e514a9",
      "symbol": "HYCA10",
      "acceptedSymbol": "HYCA10",
      "synonymSymbol": null,
      "commonName": "Aaron's beard",
      "scientificName": "Hypericum calycinum L.",
      "hybridGenusIndicator": null,
      "hybridSpeciesIndicator": null,
      "species": "calycinum",
      "subspeciesPrefix": null,
      "hybridSubspeciesIndicator": null,
      "subspecies": null,
      "varietyPrefix": null,
      "hybridVarietyIndicator": null,
      "variety": null,
      "subvarietyPrefix": null,
      "subvariety": null,
      "formaPrefix": null,
      "forma": null,
      "generaBinomialAuthor": "L.",
      "trinomialAuthor": null,
      "quadranomialAuthor": null,
      "questionableTaxonIndicator": null,
      "parents": null,
      "stateAndProvince": "USA (CA, OR, TN, WA)",
      "category": "Dicot",
      "family": "Clusiaceae",
      "familySymbol": "CLUSIA",
      "familyCommonName": "Mangosteen family",
      "order": "Theales",
      "subclass": "Dilleniidae",
      "class": "Magnoliopsida",
      "subdivision": null,
      "division": "Magnoliophyta",
      "superdivision": "Spermatophyta",
      "subkingdom": "Tracheobionta",
      "kingdom": "Plantae",
      "duration": "Perennial",
      "growthHabit": "Subshrub, Shrub",
      "nativeStatus": "L48 (I)",
      "federalNoxiousStatus": null,
      "stateNoxiousStatus": null,
      "stateNoxiousCommonName": null,
      "invasive": null,
      "federalTeStatus": null,
      "stateTeStatus": null,
      "stateTeCommonName": null,
      "activeGrowthPeriod": "Spring and Summer"
    }

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

Was this page helpful?