list_discounts
List Discounts
Retrieve all discount configurations. Discounts can be percentage-based or fixed amounts, applied at receipt or item level.
list_discounts
Retrieve all discount configurations. Discounts can be percentage-based or fixed amounts, applied at receipt or item level.
create_refund
Create a refund for an existing sales receipt. Refunded items are automatically restocked. Only receipts paid with a single payment type can be refunded via the API.
create_or_update_tax
Create a new tax rate or update an existing one. Taxes can be configured as included in or added to item prices.
delete_discount
Delete a discount by its ID.
delete_tax
Delete a tax configuration by its ID.
delete_item
Delete an item (product) from the catalog by its ID. This is a permanent operation.
get_receipt
Retrieve a single sales receipt by its receipt number, including full line items, payment details, taxes, and discounts.
create_receipt
Create a new sales receipt (transaction). The receipt includes line items, payment information, and optionally a customer. Use this to record sales programmatically.
list_shifts
Retrieve shift records including open/close times, sales totals, and associated employee information. Can filter by store or employee.
create_or_update_supplier
Create a new supplier or update an existing one. Suppliers are used for inventory sourcing and can be linked to items.
update_inventory
Update stock levels for item variants across store locations. Supports batch updates for multiple variants and stores in a single request.
delete_category
Delete a category by its ID.
list_payment_types
Retrieve all configured payment types (e.g., cash, card, custom). Payment type IDs are needed when creating receipts.
list_categories
Retrieve all item categories. Categories are used to organize items in the catalog.
list_modifiers
Retrieve all item modifiers (e.g., "Size" with options Small/Medium/Large). Modifiers add selectable options with price adjustments to items.
create_or_update_customer
Create a new customer or update an existing one. If a **customerId** is provided, the customer is updated; otherwise a new customer is created. Customers can be looked up by email or phone number using the List Customers tool before updating.
delete_supplier
Delete a supplier record by its ID.
list_employees
Retrieve employee records. Employees can only be read via the API; create/update/delete operations must be done through the Loyverse Back Office.
get_item
Retrieve a single item (product) by its ID, including full variant details, pricing, and configuration.
delete_customer
Delete a customer record by its ID.
delete_modifier
Delete a modifier by its ID.
create_or_update_category
Create a new category or update an existing one. Categories organize items in the Loyverse catalog.
list_stores
Retrieve all store locations and their configurations.
list_items
Retrieve items (products) from the Loyverse catalog. Supports filtering by update time for syncing recently changed products. Returns paginated results with variants, pricing, stock tracking, and category assignments.
list_customers
Retrieve customer records from Loyverse. Supports filtering by email, phone number, and date ranges for syncing customer data. Returns paginated results.
create_or_update_item
Create a new item (product) or update an existing one in the catalog. If an **itemId** is provided, the item is updated; otherwise a new item is created. Supports setting variants, pricing, categories, taxes, and modifiers.
list_taxes
Retrieve all tax configurations. Taxes can be applied to items and receipts.
create_or_update_discount
Create a new discount or update an existing one. Supports percentage and fixed-amount discounts.
list_suppliers
Retrieve all supplier records used for inventory sourcing.
get_merchant
Retrieve account-level merchant information including business name, email, and configuration.
get_inventory
Retrieve inventory (stock) levels for item variants across store locations. Filter by store or variant to check specific stock levels. Use this endpoint instead of the Items endpoint to get stock information.
create_or_update_modifier
Create a new modifier or update an existing one. Modifiers define selectable options (e.g., Size: S/M/L) with optional price adjustments.
list_receipts
Retrieve sales receipts (transactions) from Loyverse. Supports date range filtering for syncing sales data to external systems. Returns line items, payments, discounts, and tax details.
Manage a cloud-based point-of-sale system for retail stores, cafes, and restaurants. Create, read, update, and delete items, categories, modifiers, and variants in the product catalog. Track and update inventory stock levels across multiple store locations. Create sales receipts and process refunds. Manage customer records with lookup by email or phone. Create and configure discounts, tax rates, suppliers, and POS devices. Read employee and shift data. Retrieve store locations, payment types, and merchant information. Receive real-time webhooks for receipt, item, inventory, customer, shift, employee, and store events.
Common questions about connecting Loyverse to AI agents with Metorial.