❗Check documentation for API v3

Plant.id API v2 Documentation

Plant.id offers a machine learning-based plant identification service. Once you have obtained the API key, you can try out our sample code to speed up the development of your implementation.

API description

Plant.id provides JSON REST API. Basic usage of the API is via POST and GET requests with Content-Type application/json. The POST requests typically contain your data in the following format:

{
    "str_param": "value",
    "int_param": 123,
    ...
}

In this format, images are decoded as Base64 encoded strings.

Alternatively, you can send your data with Content-Type multipart/form-data. In this case, images will be sent as files and your parameters as JSON strings in the data field. Even if you don't want to send any additional parameters, the data field must be present as empty JSON {}.

Authentication

For authentication you will need a personal api_key (get one here).

The easiest way how to authenticate is to include the Api-Key header with your api_key. For other authentication methods see Authentication.

API endpoints

• Plant Identification 🪴

• Plant Health Assessment 🥀

• API usage info ℹ️

• Delete identification 🗑️

API features

• Plant Details
• Disease Details
• Similar Images
• Modifiers

API response example

The result is in JSON format.

• Species identification response example

• Health assessment response example

• Common API error responses❓

Usage examples

• Postman Collection
• Python
• Java
• JavaScript
• node.js
• PHP
• Rust
• Swift

Online support

See our FAQ.

If you need help, contact us at [email protected].