Flora Codex API
Flora Codex is an API that provides you structured botanical data about plants. Specifically, taxonomy and accepted names, common names, traits, where plants grow, and how to grow them. Every response is JSON, paginated, and shaped the same way, so once you have read one endpoint, the rest will seem intuitive.
It is an ordinary REST API that has all the typical RESTful things: Resource
URLs, JSON responses, standard HTTP status codes, and a credential in the
Authorization header. If you have used a REST API before, nothing here will
surprise you.
Base URL
The current version is v2, served at https://api.floracodex.com/v2. Every path in these docs
is relative to it, and all requests go over HTTPS.
Versions at a glance
There are three versions. Start new work on v2.
| Version | Status | Description |
|---|---|---|
| v1 | Deprecated |
Original, Trefle-compatible API. Sunsets on 31 January 2027. |
| v2 | Current |
The current, supported API: Consistent field names, predictable pagination, and modern errors. |
| v3 | Closed Preview |
Upcoming Flora Codex API, still taking shape. A few endpoints are available for early testing. |
Versioning explains how the three relate; the migration guide covers moving off v1.
Where to go next
- Authentication: Get a key, and the two ways to send it.
- Quickstart: Make your first call.
- Making requests: The response envelope, pagination, and headers.
- API reference: Every endpoint, with its parameters and full response schema.