Skip to main content
The GET /plants endpoint returns all plants available to your account. You can use the limit query parameter to control the maximum number of results in the response. If you omit limit, the API returns all plants without a cap. This endpoint is useful for displaying a plant catalog or syncing your local data with the store.

​
Query parameters

​
limit
integer
Maximum number of plants to return. If omitted, all plants are returned. Must be a positive integer.

​
Response

A successful request returns an array of Plant objects.

​
200 — success

​
name
string
required
Common name of the plant (for example, "Monstera").
​
tag
string
Optional category tag for the plant (for example, "tropical").

​
400 — error

​
error
integer
required
Numeric error code identifying the type of failure.
​
message
string
required
Human-readable description of the error.

​
Example

curl -X GET "http://sandbox.mintlify.com/plants?limit=10" \
  -H "Authorization: Bearer <your-token>"

[
  {
    "name": "Monstera",
    "tag": "tropical"
  },
  {
    "name": "Cactus",
    "tag": "desert"
  }
]