--- title: "Retrieve a plant" method: GET path: "/api/v1/plants/{id}" tags: ["Plants"] --- # Retrieve a plant `GET /api/v1/plants/{id}` Get a plant ## Path parameters - `id` string, required ## Response `200` Success - object - `data` Plant - `id` integer, required - `common_name` string, nullable - `slug` string, required - `scientific_name` string, required - `year` integer, nullable - `bibliography` string, nullable - `author` string, nullable - `family_common_name` string, nullable - `genus_id` integer - `main_species_id` integer, nullable - `vegetable` boolean, nullable - `observations` string, nullable - `main_species` Species - `id` integer, required — An unique identifier - `common_name` string, nullable — The usual common name, in english, of the species (if any). - `slug` string, required — An unique human-readable identifier (if you can, prefer to use this over id) - `scientific_name` string, required — The scientific name follows the [Binomial nomenclature](https://en.wikipedia.org/wiki/Binomial_nomenclature), and represents its genus and its species within the genus, resulting in a single worldwide name for each organism. The scientific name of an infraspecific taxons (ranks below species, such as subspecies, forms, varieties...) is a combination of the name of a species and an infraspecific epithet. A connecting term is used to denote the rank. [See IAPT recommendation](https://www.iapt-taxon.org/nomen/pages/main/art_24.html) - `year` integer, nullable — The first publication year of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) - `bibliography` string, nullable — The first publication of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) - `author` string, nullable — The author(s) of the first publication of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) - `status` 'accepted' | 'unknown' — The acceptance status of this species by IPNI - `rank` 'species' | 'ssp' | 'var' | 'form' | 'hybrid' | 'subvar' — The [taxonomic rank](https://en.wikipedia.org/wiki/Taxonomic_rank) of the species - `family_common_name` string, nullable — The common name (in english) of the species family - `family` string — The scientific name of the species family - `genus_id` integer — The id of the species genus - `genus` string — The scientific name of the species genus - `image_url` string, nullable — A main image url of the species - `links` object — API endpoints to related resources - `self` string, required — API endpoint to the species itself - `genus` string, required — API endpoint to the species genus - `plant` string, required — API endpoint to the species plant - `duration` string[], nullable — The plant duration(s), which can be: - Annual: plants that live, reproduce, and die in one growing season. - Biennial: plants that need two growing seasons to complete their life cycle, normally completing vegetative growth the first year and flowering the second year. - Perennial: plants that live for more than two years, with the shoot system dying back to soil level each year. - `edible_part` string[], nullable — The plant edible part(s), if any. - `edible` boolean, nullable — Is the species edible? - `vegetable` boolean, nullable — Is the species a vegetable? - `observations` string, nullable — Some habit observations on the species - `images` object - `flower` object[] — Image(s) of the species flower - `id` integer — An unique identifier - `image_url` string — The url of the image - `copyright` string, nullable — A copyright (if any) for the image. Don't forget to properly credit the author if you're using them - `leaf` object[] — Image(s) of the species leaf - `id` integer — An unique identifier - `image_url` string — The url of the image - `copyright` string, nullable — A copyright (if any) for the image. Don't forget to properly credit the author if you're using them - `habit` object[] — Image(s) of the species habit - `id` integer — An unique identifier - `image_url` string — The url of the image - `copyright` string, nullable — A copyright (if any) for the image. Don't forget to properly credit the author if you're using them - `fruit` object[] — Image(s) of the species fruit - `id` integer — An unique identifier - `image_url` string — The url of the image - `copyright` string, nullable — A copyright (if any) for the image. Don't forget to properly credit the author if you're using them - `bark` object[] — Image(s) of the species bark - `id` integer — An unique identifier - `image_url` string — The url of the image - `copyright` string, nullable — A copyright (if any) for the image. Don't forget to properly credit the author if you're using them - `other` object[] — Image(s) of the species other - `id` integer — An unique identifier - `image_url` string — The url of the image - `copyright` string, nullable — A copyright (if any) for the image. Don't forget to properly credit the author if you're using them - `common_names` object — Common names of the species per language - `distribution` object — (Deprecated) Distribution of the species per establishment - `distributions` object — Distribution of the species per establishment - `native` object[] — Zones the species is native from - `id` integer — An unique identifier - `name` string — The zone name - `slug` string — An unique, human readable, identifier - `tdwg_code` string — The TDWG zone unique code - `tdwg_level` integer — The TDWG zone level - `species_count` integer — The number of species in this zone - `links` object - `self` string — API endpoint to the zone itself - `species` string — API endpoint to the species in this zone - `plants` string — API endpoint to the plants in this zone - `introduced` object[] — Zones the species has been introduced - `id` integer — An unique identifier - `name` string — The zone name - `slug` string — An unique, human readable, identifier - `tdwg_code` string — The TDWG zone unique code - `tdwg_level` integer — The TDWG zone level - `species_count` integer — The number of species in this zone - `links` object - `self` string — API endpoint to the zone itself - `species` string — API endpoint to the species in this zone - `plants` string — API endpoint to the plants in this zone - `doubtful` object[] — Zones the species presence is doubtful - `id` integer — An unique identifier - `name` string — The zone name - `slug` string — An unique, human readable, identifier - `tdwg_code` string — The TDWG zone unique code - `tdwg_level` integer — The TDWG zone level - `species_count` integer — The number of species in this zone - `links` object - `self` string — API endpoint to the zone itself - `species` string — API endpoint to the species in this zone - `plants` string — API endpoint to the plants in this zone - `absent` object[] — Zones the species is absent and has been wrongly recorded - `id` integer — An unique identifier - `name` string — The zone name - `slug` string — An unique, human readable, identifier - `tdwg_code` string — The TDWG zone unique code - `tdwg_level` integer — The TDWG zone level - `species_count` integer — The number of species in this zone - `links` object - `self` string — API endpoint to the zone itself - `species` string — API endpoint to the species in this zone - `plants` string — API endpoint to the plants in this zone - `extinct` object[] — Zones the species is extinct - `id` integer — An unique identifier - `name` string — The zone name - `slug` string — An unique, human readable, identifier - `tdwg_code` string — The TDWG zone unique code - `tdwg_level` integer — The TDWG zone level - `species_count` integer — The number of species in this zone - `links` object - `self` string — API endpoint to the zone itself - `species` string — API endpoint to the species in this zone - `plants` string — API endpoint to the plants in this zone - `flower` object — Flower related fields (the reproductive structure found in flowering plants) - `color` string[], nullable — The flower color(s) - `conspicuous` boolean, nullable — Is the flower visible? - `foliage` object — Foliage (or leaves) related fields - `texture` 'fine' | 'medium' | 'coarse' | 'null', nullable — The general texture of the plant’s foliage - `color` string[], nullable — The leaves color(s) - `leaf_retention` boolean, nullable — Does the leaves stay all year long? - `fruit_or_seed` object — Fruit or seed related fields - `conspicuous` boolean, nullable — Is the fruit visible? - `color` string[], nullable — The fruit color(s) - `shape` string, nullable — Fruit shape - `seed_persistence` boolean, nullable — Are the fruit or seed generally recognized as being persistent on the plant? - `specifications` object — Species's main characteristics - `ligneous_type` 'liana' | 'subshrub' | 'shrub' | 'tree' | 'parasite' | 'null', nullable — The ligneous type of the woody plant - `growth_form` string, nullable — The primary growth form on the landscape in relation to soil stabilization on slopes and streamsides? Each plant species is assigned the single growth form that most enhances its ability to stabilize soil - `growth_habit` string, nullable — The general appearance, growth form, or architecture of the plant - `growth_rate` string, nullable — The relative growth speed of the plant - `average_height` object — The average height of the species, in centimeters - `cm` integer, nullable — The average height of the species, in centimeters - `maximum_height` object — The maximum height of the species, in centimeters - `cm` integer, nullable — The maximum height of the species, in centimeters - `nitrogen_fixation` string, nullable — Capability to fix nitrogen in monoculture - `shape_and_orientation` string, nullable — The predominant shape of the species - `toxicity` 'none' | 'low' | 'medium' | 'high' | 'null', nullable — Relative toxicity of the species for humans or animals - `growth` object — Growing of farming related fields - `days_to_harvest` number, nullable — The average numbers of days required to from planting to harvest - `description` string, nullable — A description on how the plant usually grows - `sowing` string, nullable — A description on how to sow the plant - `ph_maximum` number, nullable — The maximum acceptable soil pH (of the top 30 centimeters of soil) for the plant - `ph_minimum` number, nullable — The minimum acceptable soil pH (of the top 30 centimeters of soil) for the plant - `light` integer, nullable — Required amount of light, on a scale from 0 (no light, <= 10 lux) to 10 (very intensive insolation, >= 100 000 lux) - `atmospheric_humidity` integer, nullable — Required relative humidity in the air, on a scale from 0 (<=10%) to 10 (>= 90%) - `growth_months` string[], nullable — The most active growth months of the species (usually all year round for perennial plants) - `bloom_months` string[], nullable — The months the species usually blooms - `fruit_months` string[], nullable — The months the species usually produces fruits - `row_spacing` object — The minimum spacing between each rows of plants, in centimeters - `cm` number, nullable — The minimum spacing between each rows of plants, in centimeters - `spread` object — The average spreading of the plant, in centimeters - `cm` number, nullable — The average spreading of the plant, in centimeters - `minimum_precipitation` object — Minimum precipitation per year, in milimeters per year - `mm` number, nullable — Minimum precipitation per year, in milimeters per year - `maximum_precipitation` object — Maximum precipitation per year, in milimeters per year - `mm` number, nullable — Maximum precipitation per year, in milimeters per year - `minimum_root_depth` object — Minimum depth of soil required for the species, in centimeters. Plants that do not have roots such as rootless aquatic plants have 0 - `cm` number, nullable — Minimum depth of soil required for the species, in centimeters. Plants that do not have roots such as rootless aquatic plants have 0 - `minimum_temperature` object — The minimum tolerable temperature for the species. In celsius or fahrenheit degrees - `deg_f` number, nullable — The minimum tolerable temperature for the species. In fahrenheit degrees - `deg_c` number, nullable — The minimum tolerable temperature for the species. In celsius degrees - `maximum_temperature` object — The maximum tolerable temperature for the species. In celsius or fahrenheit degrees - `deg_f` number, nullable — The maximum tolerable temperature for the species. In fahrenheit degrees - `deg_c` number, nullable — The maximum tolerable temperature for the species. In celsius degrees - `soil_nutriments` integer, nullable — Required quantity of nutriments in the soil, on a scale from 0 (oligotrophic) to 10 (hypereutrophic) - `soil_salinity` integer, nullable — Tolerance to salinity, on a scale from 0 (untolerant) to 10 (hyperhaline) - `soil_texture` integer, nullable — Required texture of the soil, on a scale from 0 (clay) to 10 (rock) - `soil_humidity` integer, nullable — Required humidity of the soil, on a scale from 0 (xerophile) to 10 (subaquatic) - `synonyms` object[] — The symonyms scientific names and authors - `id` integer — An unique identifier - `name` string — The scientific name of the symonym - `author` string, nullable — The author of the symonym - `sources` object[] — The symonyms scientific names and authors - `id` string — An unique identifier from the source - `name` string — The name of the source - `citation` string, nullable — How to cite the source - `url` string, nullable — The link on the source website, or the publication reference - `last_update` string — The last time the source was checked - `extras` unknown - `sources` Source[] - `id` string, nullable - `name` string, required - `url` string, nullable - `last_update` string, required - `citation` string, nullable - `links` object, required - `self` string, required - `genus` string, required - `species` string, required - `meta` object - `last_modified` string ## Other responses - `401` — Invalid credentials --- [API](https://skmtc.net/treflehq/apis/trefle-api-v1.md) · [All operations](https://skmtc.net/treflehq/apis/trefle-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treflehq/trefle-api-v1/versions/2e0d8882f840/schema)