GET /plants — retrieve all plants from the store

Retrieve a list of all plants you have access to in the Plant Store sandbox, with an optional limit on the number of results returned.

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

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

200

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