Diseases identification

General information

Diseases identification returns a top-list of probable plant diseases, identified by their EPPO code, presented in decreasing order of confidence score.

This feature currently supports only a limited list of species and pathologies.

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.

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

Routes list

/v2/diseases
- Get the list of identifiable diseases
/v2/diseases/identify
- Identify a disease 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 diseases 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 disease.

There are diseases with no public illustration at this time.

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 diseases. Fewer results improve response time.

Prefix (/diseases)

Limit results to diseases having a name or label starting with given prefix.

Ouput format

Output of /diseases route is of the following form.

[
  {
    "label": "Coccidae",
    "name": "1COCCF",
    "categories": []
  },
  (…)
]

label is the short description of the disease.

name is the EPPO code of the disease.

Output of /diseases/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 diseases, by order of confidence score decreasing.

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/diseases`

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

[
  {
    "label": "Rhabdocline",
    "name": "1RBDCG",
    "categories": [
      "Leotiomycetes"
    ]
  },
  {
    "label": "Rattus",
    "name": "1RATTG",
    "categories": [
      "Mammalia"
    ]
  }
]

POST `/v2/diseases/identify`

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

{
  "query": {
    "images": [
      "aa61db9942e9bc71f9e93aaad4374304"
    ],
    "organs": [
      "auto"
    ],
    "includeRelatedImages": true,
    "noReject": false
  },
  "language": "fr",
  "results": [
    {
      "name": "APHISP",
      "score": 0.91427,
      "images": [
        {
          "organ": "bark",
          "author": "Ephytia − D.Blancard - INRAE − Ephytia",
          "license": "cc-by-sa",
          "date": {
            "timestamp": 1702309142589,
            "string": "11 décembre 2023"
          },
          "url": {
            "o": "https://bs.plantnet.org/image/o/7ea38c7be4b07a8ad11ca555b4139cd3c66dcda1",
            "m": "https://bs.plantnet.org/image/m/7ea38c7be4b07a8ad11ca555b4139cd3c66dcda1",
            "s": "https://bs.plantnet.org/image/s/7ea38c7be4b07a8ad11ca555b4139cd3c66dcda1"
          },
          "citation": "Ephytia − D.Blancard - INRAE − Ephytia / Pl@ntNet, cc-by-sa"
        },
        {
          "organ": "bark",
          "author": "Ephytia − D.Blancard - INRAE − Ephytia",
          "license": "cc-by-sa",
          "date": {
            "timestamp": 1702309142607,
            "string": "11 décembre 2023"
          },
          "url": {
            "o": "https://bs.plantnet.org/image/o/d0103e278e709b68f1b3716a68cc3fba9f50d5e0",
            "m": "https://bs.plantnet.org/image/m/d0103e278e709b68f1b3716a68cc3fba9f50d5e0",
            "s": "https://bs.plantnet.org/image/s/d0103e278e709b68f1b3716a68cc3fba9f50d5e0"
          },
          "citation": "Ephytia − D.Blancard - INRAE − Ephytia / Pl@ntNet, cc-by-sa"
        },
        (…)
      ],
      "description": "Aphis sp."
    },
    {
      "name": "ELSIAM",
      "score": 0.02946,
      "images": [
        {
          "organ": "bark",
          "author": "Ephytia − D.Blancard - INRAE − Ephytia",
          "license": "cc-by-sa",
          "date": {
            "timestamp": 1702309155163,
            "string": "11 décembre 2023"
          },
          "url": {
            "o": "https://bs.plantnet.org/image/o/5cf7905e4c708d3c9ed4f6ba34e85509095636b5",
            "m": "https://bs.plantnet.org/image/m/5cf7905e4c708d3c9ed4f6ba34e85509095636b5",
            "s": "https://bs.plantnet.org/image/s/5cf7905e4c708d3c9ed4f6ba34e85509095636b5"
          },
          "citation": "Ephytia − D.Blancard - INRAE − Ephytia / Pl@ntNet, cc-by-sa"
        }
      ],
      "description": "Elsinoë ampelina - Anthracnose maculée de la vigne"
    },
    {
      "name": "TRANSP",
      "score": 0.00432,
      "images": [],
      "description": "Tranzschelia sp."
    },
    (…)
  ],
  "version": "2025-08-08 (7.4)",
  "remainingIdentificationRequests": 495
}