Use inventory and vendor APIs
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_quantitythresholds from the product APIs to trigger automatic reorder notifications. - Stock movement data provides a complete audit trail of inventory changes, useful for reconciliation.