> ## Documentation Index
> Fetch the complete documentation index at: https://agentmall.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# REST API

> HTTPS routes at api.getagentmall.com.

Base URL `https://api.getagentmall.com`. `/v1/*` needs `Authorization: Bearer <key>`. `GET /health` is open. Bodies match the [MCP tools](https://agentmall.mintlify.site/mcp/tools.md). Walmart only: `merchant_id` is `mrc_walmart`.

| Method | Path | Tool |
| - | - | - |
| `GET` | `/health` | Liveness |
| `POST` | `/v1/catalog/search` | `search_catalog` |
| `POST` | `/v1/catalog/lookup` | `lookup_catalog` |
| `POST` | `/v1/carts` | `create_cart` |
| `GET` | `/v1/carts/:id` | `get_cart` |
| `PUT` | `/v1/carts/:id` | `update_cart` |
| `POST` | `/v1/carts/:id/cancel` | `cancel_cart` |
| `POST` | `/v1/carts/:id/sign-in` | `sign_in` |
| `POST` | `/v1/carts/:id/sign-in/otp` | `submit_sign_in_otp`. Body `{ code }` |
| `POST` | `/v1/carts/:id/checkout` | `create_checkout` |
| `GET` | `/v1/carts/:id/checkout` | `get_checkout` |
| `PUT` | `/v1/carts/:id/checkout` | `update_checkout` |
| `POST` | `/v1/carts/:id/checkout/cancel` | `cancel_checkout` |
| `POST` | `/v1/carts/:id/checkout/complete` | `complete_checkout`. Body `{ review_hash, total_minor }` |
| `GET` | `/v1/orders/:id` | `get_order` |

`get_product` and `sign_out` are MCP only. The console is not on this API. It reads the signed-in organization's rows itself.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.