> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mycargoextra.com/_mcp/server.

# Overview

Standard API documentation for CargoExtra Gateway Service. Base path: `/api/v1`. Import this JSON into Postman, set `baseUrl`, then authenticate as a user or admin and reuse the returned token in `userToken` or `adminToken`.

Authentication: protected user endpoints accept `Authorization: Bearer {{userToken}}` or the `customerToken/userToken` cookie set by login. Protected admin endpoints accept `Authorization: Bearer {{adminToken}}` or the `staffToken/adminToken` cookie set by login.

Common list query parameters: `page` number, `limit` number max 100, `sortBy` string, `sortOrder` `asc|desc`, `all` 1 to bypass pagination, `q` text search, `dateFrom/from`, `dateTo/to` for date ranges where supported.

Common error responses: `401 { "message": "Unauthorized" }`, `400` for missing/invalid fields, `404` for missing resources, and `500 { "message": "Unxepected Error: ..." }` in unexpected failures.

## Docs

- [Overview](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/plant.md)
- [Overview](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/store.md)
- [Overview](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/user.md)

## API Docs

- Swagger Plant Store - OpenAPI 3.1 > plant [Add a new plant to the store](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/plant/add-plant.md)
- Swagger Plant Store - OpenAPI 3.1 > plant [Update an existing plant](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/plant/update-plant.md)
- Swagger Plant Store - OpenAPI 3.1 > plant [Search plants by status](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/plant/search-plants-by-status.md)
- Swagger Plant Store - OpenAPI 3.1 > plant [Search plants by tags](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/plant/search-plants-by-tags.md)
- Swagger Plant Store - OpenAPI 3.1 > plant [Find plant by ID](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/plant/get-plant-by-id.md)
- Swagger Plant Store - OpenAPI 3.1 > user [Logs user into the system](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/user/login-user.md)
- Swagger Plant Store - OpenAPI 3.1 > user [Logs out current logged-in user session](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/user/logout-user.md)
- Swagger Plant Store - OpenAPI 3.1 > user [Get user by username](https://docs.mycargoextra.com/swagger-plant-store-open-api-3-1/user/get-user-by-name.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.mycargoextra.com/openapi.json)
- [OpenAPI YAML](https://docs.mycargoextra.com/openapi.yaml)