Skip to main content
Client sends HTTPS requests to api.getagentmall.com and receives JSON responses The REST API exposes the same operations as MCP, over HTTPS at api.getagentmall.com. Every /v1/* route needs Authorization: Bearer <key>. Request and response bodies are JSON. Prices and totals are integer minor units of the merchant’s currency (cents for USD, pence for GBP). GET /v1/merchants lists the nine live merchant ids. get_product and sign_out are MCP only. The console is not on this API.

Health

GET /health

No auth required. Returns 200 when the server is up.

Catalog

POST /v1/catalog/search

Equivalent to MCP search_catalog.

POST /v1/catalog/lookup

Equivalent to MCP lookup_catalog. Reads up to 10 product pages in one call.

Cart

POST /v1/carts

Equivalent to MCP create_cart. Starts an empty cart and returns its id.

GET /v1/carts/:id

Equivalent to MCP get_cart. Reads the live merchant cart.

PUT /v1/carts/:id

Equivalent to MCP update_cart. Replaces the cart: clears, then adds each line.
Response is the same shape as GET /v1/carts/:id.

POST /v1/carts/:id/cancel

Equivalent to MCP cancel_cart. Returns the cart as last stored, then releases the browser.

Sign-in

POST /v1/carts/:id/sign-in

Equivalent to MCP sign_in. Pass Evervault-encrypted (ev:…) email and password.
When the merchant sends an SMS challenge:

POST /v1/carts/:id/sign-in/otp

Equivalent to MCP submit_sign_in_otp. Submits the SMS code after a challenge.

Checkout

POST /v1/carts/:id/checkout

Equivalent to MCP create_checkout. Opens checkout and returns the review.

GET /v1/carts/:id/checkout

Equivalent to MCP get_checkout. Re-reads without changing the page.
Same response shape as POST /v1/carts/:id/checkout.

PUT /v1/carts/:id/checkout

Equivalent to MCP update_checkout. Writes an address, selects a method, or adds a card.
Returns the checkout with updated totals and a new review_hash.

POST /v1/carts/:id/checkout/cancel

Equivalent to MCP cancel_checkout. Leaves checkout without placing. The cart stays open.

POST /v1/carts/:id/checkout/complete

Equivalent to MCP complete_checkout. Places the order when review_hash and total_minor match.

Order

GET /v1/orders/:id

Equivalent to MCP get_order. Reads an order by platform id.

Errors

Every error response has error.code and error.message:
HTTP status codes follow standard conventions: 400 for bad input, 401 for auth failures, 404 for not found, 410 for expired sessions, 429 for rate limits. See Error codes for the full list.