ZenotiHelp

Use inventory and vendor APIs

ZTZenoti Docs Team Updated March 7, 2026 2 min readGuide

The inventory and vendor APIs let you track product stock levels, view purchase and transfer orders, and manage vendor records. Use these APIs to synchronize inventory data with external systems, monitor stock levels, and integrate vendor management with your procurement workflows.

For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.


On this page


Before you begin

  • You need a valid API key or access token. See Set up API authentication.
  • Products must be configured in the center for inventory tracking.

Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.

Inventory stock

Retrieve stock quantities

GET /v1/inventory/stock

Retrieves current stock quantities for all products in a center.

Parameter Type Required Description
center_id string Yes Center identifier
inventory_date date Yes Date for the inventory snapshot
search_string string No Search products by name or code
product_type string No Filter by product type

Response: Product stock records with center_code, product_code, product_name, category, sub_category, store_quantity, floor_quantity, total_quantity.

Retrieve product consumption and stock movement

GET /v1/inventory/stock_movement

Retrieves consumption and stock movement details for products at a center during a date range.

Parameter Type Required Description
center_id string Yes Center identifier
start_date date Yes Report start date
end_date date Yes Report end date
product_code string No Filter by specific product code

Response: Movement records with opening quantities, inflow details (purchases, transfers, conversions, returns, refunds), outflow details (sales, transfers, bill of materials), checkouts, discrepancies, and closing quantities.

Purchase orders

Retrieve purchase orders

GET /v1/inventory/purchase_orders

Retrieves purchase orders for a center during a time period.

Parameter Type Required Description
center_id guid Yes Center identifier
start_date datetime Yes Start date
end_date datetime Yes End date
show_delivery_details boolean No Include delivery information
status string No Filter by order status

Response: total_orders, orders (array with order_id, order_number, center_name, vendor_name, ordered_date, closed_date, line_items with product details and quantities).

Transfer orders

Retrieve transfer orders

GET /v1/inventory/transfer_orders

Retrieves transfer orders for a center during a time period.

Parameter Type Required Description
center_id string Yes Center identifier
start_date datetime Yes Start date
end_date datetime Yes End date
show_delivery_details boolean No Include delivery information
status string No Filter by order status

Response: total_orders, orders (array with order details, line items, shipping and handling costs, and notes).

Vendors

Retrieve all vendors

GET /v1/vendors

Retrieves all vendors associated with the organization.

Parameter Type Required Description
page integer No Page number
size integer No Vendors per page

Response: Vendor records with id, name, code, description, address1, address2, work_phone, email, zip_code, city, country_id, state_id, and tax identifiers. Includes page_info for pagination.

Retrieve vendor products

GET /v1/vendors/{id}/products

Retrieves products associated with a specific vendor.

Parameter Type Required Description
id guid Yes Vendor identifier

Tips

  • Use the stock quantities endpoint to display real-time inventory levels in your storefront or ordering system.
  • Monitor alert_quantity thresholds from the product APIs to trigger automatic reorder notifications.
  • Stock movement data provides a complete audit trail of inventory changes, useful for reconciliation.

API reference

Was this article helpful?
Your feedback helps us improve our documentation.