Terra Living

Showing 25 of 26 from the live probe.

• List Products

  List or search products from the Fynd catalog. Use before add_to_cart. Returns products with images. Use inStockOnly: true to get only products with available stock.

• Get Product

  Get product details by slug. Use slug from list_products. Returns sizes if product has multiple sizes.

• List Collections

  List product collections from the catalog. Returns collection names, slugs, and logos. Use get_collection for details and products within a collection.

• List Brands

  List all brands from the catalog with pagination. Returns brand names, slugs, logos, and descriptions.

• Get Collection

  Get collection details and products by slug. Use slug from list_collections. Returns collection info, banner images, and products within the collection.

• Send Login OTP

  Send OTP to mobile for login. Rate limited: max 3 per 15 min per number. Use verify_login_otp next.

• Verify Login OTP

  Verify OTP and log in. Requires request_id from send_login_otp. Must be called before add_to_cart, get_cart, place_order.

• Complete Registration

  Complete registration after verify_login_otp returns registration_required. Ask only for the user's first and last name. The verified mobile number and registration token are retained securely from OTP verification.

• Get Session Status

  Check if user is logged in. MUST be called before any action that requires login (add_to_cart, get_cart, place_order, etc). Only prompt for login if this returns not logged in.

• Get Profile Details

  Get the authenticated user's name, mobile number, and email address. Requires login.

• Logout

  Log out and clear session.

• Add to Cart

  Add product to cart. Requires login - use get_session_status first to check if user is logged in, and only prompt for login (send_login_otp/verify_login_otp) if not logged in. Use slug from list_products. For products with multiple sizes (e.g. S, M, L), size is REQUIRED - use get_product first to see available sizes.

• Get Cart

  Get current cart contents and total. Requires login - use get_session_status first to check.

• Update Cart Item

  Update quantity of an item in cart. Requires login. Use get_cart first to get item_id and item_size.

• Remove Cart Item

  Remove an item from cart. Requires login. Use get_cart first to get item_id and item_size.

• Clear Cart

  Remove all items from cart. Requires login.

• List Coupons

  List available coupons for the current cart. Requires login. Shows applicable and non-applicable coupons with details.

• Apply Coupon

  Apply a coupon code to the cart. Requires login. Use coupon_code from list_coupons. Returns updated cart with discount applied.

• Remove Coupon

  Remove the applied coupon from the cart. Requires login. Returns updated cart without discount.

• List Addresses

  List saved delivery addresses. Returns address details including default address. Requires login.

• Add Address

  Add delivery address. Required before place_order. Pincode must be 6 digits.

• Place Order (Preview)

  Preview COD order. Returns confirmation_id. ALWAYS show cart total and ask user to confirm before calling confirm_order. COD orders cannot be cancelled. Pass pincode for COD eligibility check.

• Confirm Order

  Actually place the COD order. Only use after user explicitly confirms. Requires confirmationCode from place_order.

• Get Order Status

  Get order details and status by order ID. Requires login. Use order_id from confirm_order (e.g. FY69AB831354A9D0D668).

• Cancel Order

  Cancel an order by order ID. Requires explicit user confirmation (confirm: 'yes'). Use get_order_status first to check if the order can be cancelled. COD orders may not be cancellable.