Varieties identification

General information

Varieties identification returns a top-list of probable plant varieties along with their species, presented by species, in decreasing order of varieties confidence score.

This feature is currently limited to a small number of well-documented crops and varieties.

Confidence scores are between 0 and 1.

Up to 5 input images can be sent in a single request. Only images with image/jpeg or image/png mimetype are allowed, and total POST size (sum of input image files sizes) cannot exceed 50 MB.

One request identifies one plant. When multiple images are submitted at once, they must represent the same individual.

Varieties identification debits the same quota as single-species identification and costs 1 credit per request.

Routes list

/v2/varieties
- Get the list of identifiable varieties
/v2/varieties/identify
- Identify a variety from one or more pictures

See OpenAPI doc for details.

Input

Language

Set lang to a language code returned by /v2/languages route to get contextualized results, such as varieties descriptions.

Images and organs

images are binary files, in JPG or PNG format. You can submit up to 5 images representing the same plant individual. Use the parameter multiple times to do so.

Set organs to values among the following to indicate which plant organ is represented by each input image:

leaf
flower
fruit
bark

Use value auto to let AI detect the organ based on the image.

Number of values for organs must match number of input images. Each organ is associated to an image in the order given. If multiple images represent the same organ, use the same value multiple times.

Omitting parameter organs sets every organ to auto, in a shortest way.

Setting include-related-images to true will return a list of most-similar images for each probable variety.

Set no-reject to true to prevent the service from rejecting your image when most probable AI identification result is not a plant (human, object…) ; see FAQ (chapter "rejection") for details.

Set nb-results to an integer >= 1 to restrict size of output list of probable varieties. Fewer results improve response time.

Prefix (/varieties)

Limit results to varieties having a name starting with given prefix.

Ouput format

Output of /varieties route is of the following form.

[
  {
    "name": "Gros locard",
    "species": {}
  },
  (…)
]

name is the variety name.

species holds the details of the related species.

Output of /varieties/identify route is of the following form.

{
  "query": {},
  "language": "fr",
  "results": [],
  "version": "2025-08-08 (7.4)",
  "remainingIdentificationRequests": 495
}

query summarizes input.

results is the list of predicted probable plant varieties grouped by species, by order of confidence score decreasing.

Elements in the results array are species, varieties are stored per species, under varieties. Species images at the top level ar not related to varieties. Use varieties[*].images to illustrate varieties.

version gives the version of the AI engine that processed your request.

remainingIdentificationRequests informs you about your quota consumption for the current day.

cURL examples

GET `/v2/varieties`

curl -X POST 'https://my-api.plantnet.org/v2/varieties?prefix=Ros&api-key=YOUR_API_KEY'

[
  {
    "name": "Rosa du Perche",
    "species": {
      "scientificName": "Malus domestica (Suckow) Borkh.",
      "scientificNameWithoutAuthor": "Malus domestica",
      "scientificNameAuthorship": "(Suckow) Borkh.",
      "genus": "Malus",
      "family": "Rosaceae",
      "commonNames": [
        "Apple"
      ],
      "gbif": {
        "id": "3001244"
      }
    }
  },
  {
    "name": "Rose claire",
    "species": {
      "scientificName": "Solanum lycopersicum L.",
      "scientificNameWithoutAuthor": "Solanum lycopersicum",
      "scientificNameAuthorship": "L.",
      "genus": "Solanum",
      "family": "Solanaceae",
      "commonNames": [
        "Tomato"
      ],
      "gbif": {
        "id": "2930137"
      }
    }
  },
  {
    "name": "Rose de Berne",
    "species": {
      "scientificName": "Solanum lycopersicum L.",
      "scientificNameWithoutAuthor": "Solanum lycopersicum",
      "scientificNameAuthorship": "L.",
      "genus": "Solanum",
      "family": "Solanaceae",
      "commonNames": [
        "Tomato"
      ],
      "gbif": {
        "id": "2930137"
      }
    }
  }
]

POST `/v2/varieties/identify`

curl -X POST 'https://my-api.plantnet.org/v2/varieties/identify?include-related-images=true&lang=fr&api-key=YOUR_API_KEY' -F image=@/path/to/disease_image.jpg

{
  "query": {
    "images": [
      "f205305893f84ee8b68978f5dbcb92b3"
    ],
    "organs": [
      "auto"
    ],
    "includeRelatedImages": true,
    "noReject": false
  },
  "language": "fr",
  "results": [
    {
      "score": 0.15584,
      "species": {
        "scientificNameWithoutAuthor": "Malus domestica",
        "scientificNameAuthorship": "(Suckow) Borkh.",
        "genus": {
          "scientificNameWithoutAuthor": "Malus",
          "scientificNameAuthorship": "",
          "scientificName": "Malus"
        },
        "family": {
          "scientificNameWithoutAuthor": "Rosaceae",
          "scientificNameAuthorship": "",
          "scientificName": "Rosaceae"
        },
        "commonNames": [
          "Pommier commun",
          "Pommier cultivé",
          "Pommier domestique"
        ],
        "scientificName": "Malus domestica (Suckow) Borkh."
      },
      "images": [
        {
          "organ": "fruit",
          "author": "Pomme Pépin",
          "license": "cc-by-sa",
          "date": {
            "timestamp": 1708015813573,
            "string": "15 février 2024"
          },
          "url": {
            "o": "https://bs.plantnet.org/image/o/2bf0f990e9aceb66166f60f413033154c7239e22",
            "m": "https://bs.plantnet.org/image/m/2bf0f990e9aceb66166f60f413033154c7239e22",
            "s": "https://bs.plantnet.org/image/s/2bf0f990e9aceb66166f60f413033154c7239e22"
          },
          "citation": "Pomme Pépin / Pl@ntNet, cc-by-sa"
        },
        (…)
      ],
      "gbif": {
        "id": "3001244"
      },
      "powo": {
        "id": "726282-1"
      },
      "varieties": [
        {
          "name": "Coing",
          "score": 0.26517,
          "images": [
            {
              "organ": "fruit",
              "author": "Pomme Pépin",
              "license": "cc-by-sa",
              "date": {
                "timestamp": 1708015482467,
                "string": "15 février 2024"
              },
              "url": {
                "o": "https://bs.plantnet.org/image/o/2c35c5792ddba5bfb9f73eb5c0a0f006818aa859",
                "m": "https://bs.plantnet.org/image/m/2c35c5792ddba5bfb9f73eb5c0a0f006818aa859",
                "s": "https://bs.plantnet.org/image/s/2c35c5792ddba5bfb9f73eb5c0a0f006818aa859"
              },
              "citation": "Pomme Pépin / Pl@ntNet, cc-by-sa"
            }
          ]
        },
        {
          "name": "Franc rougeau",
          "score": 0.07389,
          "images": [
            {
              "organ": "fruit",
              "author": "Ac. Orléans-Tours - URGC - Ac. Orléans-Tours − URGC",
              "license": "cc-by-sa",
              "date": {
                "timestamp": 1713183575495,
                "string": "15 avril 2024"
              },
              "url": {
                "o": "https://bs.plantnet.org/image/o/9764589b5010a7c208a9c830c072b146d5a08ab7",
                "m": "https://bs.plantnet.org/image/m/9764589b5010a7c208a9c830c072b146d5a08ab7",
                "s": "https://bs.plantnet.org/image/s/9764589b5010a7c208a9c830c072b146d5a08ab7"
              },
              "citation": "Ac. Orléans-Tours - URGC - Ac. Orléans-Tours − URGC / Pl@ntNet, cc-by-sa"
            },
            (…)
        },
        (…)
      ]
    },
    (…)
  ],
  "version": "2025-08-08 (7.4)",
  "remainingIdentificationRequests": 499
}