Home

Plant.id API v2 Documentation

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

API description

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

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

In this format images are decoded as Base64 encoded strings.

As alternative you can send your data with Content-Type multipart/form-data. In that case, images are send as files and your parameters as JSON string in the field data.

Authentication

For authentication you need personal api_key (request one here).

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

API endpoints

• Plant Identification 🪴

• Plant Health Assessment 🥀

• API usage info ℹ️

• Get identification result 📥

• Delete identification 🗑️

API features

• Plant Details
• Disease Details
• Similar Images
• Modifiers

API response example

The result is in the JSON format.

• Species identification response example
• Health assessment response example

Usage examples

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

Online support

See our FAQ.

If you need help, contact us at support@plant.id.