Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/zoho-inventory-replenishment-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: batches Replenishment API
description: Batches help you track inventory items by batch numbers, manufacturing dates, and expiration dates.
contact: {}
version: 1.0.0
servers:
- url: https://www.zohoapis.com/inventory/v1
description: API Endpoint
tags:
- name: replenishment
description: Replenishment Module
paths:
/items/{item_id}/locations/replenishments:
x-mcp-group:
- Replenishment
parameters:
- name: item_id
in: path
required: true
description: Unique identifier of the item.
schema:
type: string
example: 4815000000044208
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: list_item_location_replenishments
summary: Retrieve replenishment configurations for associated locations
description: Fetches the replenishment configurations of the associated locations for an item.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-replenishment-configurations-for-associated-locations-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
/items/{item_id}/warehouses/replenishments:
x-mcp-group:
- Replenishment
parameters:
- name: item_id
in: path
required: true
description: Unique identifier of the item.
schema:
type: string
example: 4815000000044208
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: list_item_warehouse_replenishments
summary: Retrieve replenishment configurations for associated warehouses
description: Fetches the replenishment configurations of the associated warehouses for an item. Applicable only when multi-warehouse is enabled for the organization.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-replenishment-configurations-for-associated-warehouses-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
/replenishments/{replenishment_configuration_id}:
x-mcp-group:
- Replenishment
parameters:
- name: replenishment_configuration_id
in: path
required: true
description: Unique identifier of the replenishment configuration.
schema:
type: string
example: 4815000000045001
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: get_replenishment_configuration
summary: Retrieve a replenishment configuration
description: Fetches the details of a replenishment configuration.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
put:
tags:
- replenishment
operationId: update_replenishment_configuration
summary: Update a replenishment configuration
description: Updates an existing replenishment configuration.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/update-a-replenishment-configuration-request'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/update-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
post:
tags:
- replenishment
operationId: create_replenishment_configuration
summary: Create a replenishment configuration
description: Creates a replenishment configuration for an item.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/create-a-replenishment-configuration-request'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/create-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.CREATE
put:
tags:
- replenishment
operationId: bulk_update_replenishments
summary: Bulk update replenishment configurations
description: Updates replenishment configurations for the specified item and location combinations.
parameters:
- name: item_ids
in: query
required: true
description: <code>List of item ids separated by comma</code>
schema:
type: string
example: 4815000000044208,4815000000044274
- name: location_ids
in: query
required: false
description: <code>List of location ids separated by comma</code>
schema:
type: string
example: 4815000000033001,4815000000033002
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/bulk-update-replenishment-configurations-request'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/bulk-update-replenishment-configurations-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/tasks:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: list_replenishment_tasks
summary: List all replenishment tasks
description: Lists replenishment tasks in your organization.
parameters:
- name: item_ids
in: query
required: false
description: <code>List of item ids separated by comma</code>
schema:
type: string
example: 4815000000044208,4815000000044274
- name: location_ids
in: query
required: false
description: <code>List of location ids separated by comma</code>
schema:
type: string
example: 4815000000033001,4815000000033002
- name: vendor_ids
in: query
required: false
description: <code>List of vendor ids separated by comma</code>
schema:
type: string
example: 4815000000009901,4815000000009902
- name: from_location_ids
in: query
required: false
description: <code>List of source location ids separated by comma</code>
schema:
type: string
example: 4815000000034001,4815000000034002
- name: order_type
in: query
required: false
description: Order type.
schema:
type: string
example: purchase_order
- name: filter_by
in: query
required: false
description: 'Filter tasks by status. Allowed values: <code>Status.All</code>, <code>Status.Pending</code>, <code>Status.Replenished</code>, <code>Status.Completed</code>, and <code>Status.Dismissed</code>.'
schema:
type: string
example: Status.Pending
- name: sort_column
in: query
required: false
description: 'Sort tasks based on the following columns: <code>item_name</code>, <code>sku</code>, <code>entry_number</code>, and <code>created_time</code>.'
schema:
type: string
example: created_time
- name: sort_order
in: query
required: false
description: 'Sort order of the tasks. Allowed values: <code>A</code> and <code>D</code>.'
schema:
type: string
default: D
example: D
- name: page
in: query
required: false
description: Page number to be fetched. Default value is 1.
schema:
type: integer
default: 1
example: 1
- name: per_page
in: query
required: false
description: Number of records to be fetched per page. Default value is 200.
schema:
type: integer
default: 200
example: 200
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/list-replenishment-tasks-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
/replenishments/tasks/{task_id}:
x-mcp-group:
- Replenishment
parameters:
- name: task_id
in: path
required: true
description: Unique identifier of the replenishment task.
schema:
type: string
example: 4815000000099001
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: get_replenishment_task
summary: Retrieve a replenishment task
description: Fetches the details of a replenishment task.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-a-replenishment-task-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
/replenishments/tasks/{task_id}/dismiss:
x-mcp-group:
- Replenishment
parameters:
- name: task_id
in: path
required: true
description: Unique identifier of the replenishment task.
schema:
type: string
example: 4815000000099001
- $ref: '#/components/parameters/organization_id'
put:
tags:
- replenishment
operationId: dismiss_replenishment_task
summary: Dismiss a replenishment task
description: Dismisses a replenishment task.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/dismiss-a-replenishment-task-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/tasks/details:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: get_replenishment_task_for_item
summary: Retrieve replenishment task details for an item
description: Fetches the replenishment task details for the specified item.
parameters:
- name: item_id
in: query
required: true
description: Unique identifier of the item.
schema:
type: string
example: 4815000000044208
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-a-replenishment-task-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
/replenishments/orders:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: get_replenishment_order_details
summary: Retrieve replenishment order details
description: Fetches the order details for a replenishment configuration.
parameters:
- name: replenishment_configuration_id
in: query
required: true
description: Unique identifier of the replenishment configuration.
schema:
type: string
example: 4815000000045001
- name: order_type
in: query
required: true
description: Order type.
schema:
type: string
example: purchase_order
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-replenishment-order-details-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.READ
/replenishments/{replenishment_configuration_id}/pause:
x-mcp-group:
- Replenishment
parameters:
- name: replenishment_configuration_id
in: path
required: true
description: Unique identifier of the replenishment configuration.
schema:
type: string
example: 4815000000045001
- $ref: '#/components/parameters/organization_id'
put:
tags:
- replenishment
operationId: pause_replenishment_configuration
summary: Pause a replenishment configuration
description: Pauses a replenishment configuration until the specified date.
parameters:
- name: pause_till_date
in: query
required: false
description: Date until which the replenishment configuration is paused.
schema:
type: string
format: date
example: '2026-05-01'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/pause-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/pause:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
put:
tags:
- replenishment
operationId: bulk_pause_replenishments
summary: Bulk pause replenishment configurations
description: Pauses replenishment configurations for the specified item and location combinations.
parameters:
- name: item_ids
in: query
required: true
description: <code>List of item ids separated by comma</code>
schema:
type: string
example: 4815000000044208,4815000000044274
- name: location_ids
in: query
required: false
description: <code>List of location ids separated by comma</code>
schema:
type: string
example: 4815000000033001,4815000000033002
- name: pause_till_date
in: query
required: false
description: Date until which the replenishment configurations are paused.
schema:
type: string
format: date
example: '2026-05-01'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/pause-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/{replenishment_configuration_id}/resume:
x-mcp-group:
- Replenishment
parameters:
- name: replenishment_configuration_id
in: path
required: true
description: Unique identifier of the replenishment configuration.
schema:
type: string
example: 4815000000045001
- $ref: '#/components/parameters/organization_id'
put:
tags:
- replenishment
operationId: resume_replenishment_configuration
summary: Resume a replenishment configuration
description: Resumes a paused replenishment configuration.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/resume-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/resume:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
put:
tags:
- replenishment
operationId: bulk_resume_replenishments
summary: Bulk resume replenishment configurations
description: Resumes paused replenishment configurations for the specified item and location combinations.
parameters:
- name: item_ids
in: query
required: true
description: <code>List of item ids separated by comma</code>
schema:
type: string
example: 4815000000044208,4815000000044274
- name: location_ids
in: query
required: false
description: <code>List of location ids separated by comma</code>
schema:
type: string
example: 4815000000033001,4815000000033002
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/resume-a-replenishment-configuration-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/tasks/dismiss:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
put:
tags:
- replenishment
operationId: bulk_dismiss_replenishment_tasks
summary: Bulk dismiss replenishment tasks
description: Dismisses the specified replenishment tasks.
parameters:
- name: replenishment_task_ids
in: query
required: true
description: <code>List of replenishment task ids separated by comma</code>
schema:
type: string
example: 4815000000099001,4815000000099002
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/dismiss-a-replenishment-task-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.UPDATE
/replenishments/{replenishment_configuration_id}/tasks/generate:
x-mcp-group:
- Replenishment
parameters:
- name: replenishment_configuration_id
in: path
required: true
description: Unique identifier of the replenishment configuration.
schema:
type: string
example: 4815000000045001
- $ref: '#/components/parameters/organization_id'
post:
tags:
- replenishment
operationId: generate_replenishment_task
summary: Generate a replenishment task
description: Generates a replenishment task for a replenishment configuration.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/generate-replenishment-task-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.CREATE
/replenishments/tasks/generate:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
post:
tags:
- replenishment
operationId: bulk_generate_replenishment_tasks
summary: Bulk generate replenishment tasks
description: Generates replenishment tasks for the specified items.
parameters:
- name: item_ids
in: query
required: true
description: <code>List of item ids separated by comma</code>
schema:
type: string
example: 4815000000044208,4815000000044274
- name: location_ids
in: query
required: false
description: <code>List of location ids separated by comma</code>
schema:
type: string
example: 4815000000033001,4815000000033002
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/generate-replenishment-task-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.items.CREATE
/reports/replenishments/tasks:
x-mcp-group:
- Replenishment
parameters:
- $ref: '#/components/parameters/organization_id'
get:
tags:
- replenishment
operationId: get_replenishment_tasks_report
summary: Retrieve replenishment task details report
description: Fetches the replenishment task details report.
parameters:
- name: filter_by
in: query
required: false
description: 'Filter the report by task date. Allowed values: <code>TaskDate.ThisMonth</code>, <code>TaskDate.ThisWeek</code>, <code>TaskDate.Today</code>, <code>TaskDate.ThisQuarter</code>, <code>TaskDate.ThisYear</code>, <code>TaskDate.PreviousDay</code>, <code>TaskDate.PreviousWeek</code>, <code>TaskDate.PreviousMonth</code>, <code>TaskDate.PreviousQuarter</code>, <code>TaskDate.PreviousYear</code>, and <code>TaskDate.CustomDate</code>.'
schema:
type: string
example: TaskDate.ThisMonth
- name: sort_column
in: query
required: false
description: 'Sort the report based on the following columns: <code>item_name</code>, <code>sku</code>, <code>entry_number</code>, <code>warehouse</code> (applicable only when multi-warehouse is enabled for the organization), <code>location</code>, <code>created_time</code>, and <code>last_modified_time</code>.'
schema:
type: string
example: created_time
- name: sort_order
in: query
required: false
description: 'Sort order of the report. Allowed values: <code>A</code> and <code>D</code>.'
schema:
type: string
default: A
example: A
- name: page
in: query
required: false
description: Page number to be fetched. Default value is 1.
schema:
type: integer
default: 1
example: 1
- name: per_page
in: query
required: false
description: Number of records to be fetched per page. Default value is 200.
schema:
type: integer
default: 200
example: 200
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-replenishment-task-details-report-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.reports.READ
components:
schemas:
sort_column:
type: string
description: Column used to sort the records.
example: created_time
list-replenishment-tasks-response:
type: object
properties:
code:
type: integer
description: Zoho Inventory error code. This will be zero for a success response and non-zero in case of an error.
example: 0
readOnly: true
message:
type: string
description: Message for the invoked API.
example: success
readOnly: true
replenishment_tasks:
type: array
description: List of replenishment tasks in the organization.
items:
$ref: '#/components/schemas/replenishment-task-response'
page_context:
type: object
description: Pagination details for the list of replenishment tasks.
properties:
page:
$ref: '#/components/schemas/page'
per_page:
$ref: '#/components/schemas/per_page'
has_more_page:
$ref: '#/components/schemas/has_more_page'
report_name:
$ref: '#/components/schemas/report_name'
applied_filter:
$ref: '#/components/schemas/applied_filter'
sort_column:
$ref: '#/components/schemas/sort_column'
sort_order:
$ref: '#/components/schemas/sort_order'
replenishment-task-response:
type: object
properties:
replenishment_task_id:
type: string
description: Unique ID generated by the server for the replenishment task. This is used as an identifier.
example: 4815000000099001
entry_number:
type: string
description: Entry number of the replenishment task.
example: RT-00001
item_id:
type: string
description: Unique ID generated by the server for the item.
example: 4815000000044208
item_name:
type: string
description: Name of the item.
example: HDMI Cable
item_status:
type: string
description: Status of the item.
example: active
unit:
type: string
description: Unit of measurement for the item.
example: pcs
location_id:
type: string
description: Unique ID generated by the server for the location.
example: 4815000000033001
location_name:
type: string
description: Name of the location.
example: New York
location_status:
type: string
description: Status of the location.
example: active
reorder_level:
type: number
format: double
description: Stock level at which the replenishment task was generated for the item.
example: 10
max_stock_level:
type: number
format: double
description: Maximum stock level configured for the item at the location.
example: 50
stock_available_for_sale:
type: number
format: double
description: Stock available for sale at the location when the replenishment task was generated.
example: 12
stock_yet_to_be_received:
type: number
format: double
description: Stock that has been ordered but is yet to be received at the location when the replenishment task was generated.
example: 0
stock_in_transit:
type: number
format: double
description: Stock that is in transit to the location when the replenishment task was generated.
example: 0
total_available_stock:
type: number
format: double
description: Total available stock for the item at the location when the replenishment task was generated.
example: 12
quantity_to_replenish:
type: number
format: double
description: Quantity that needs to be replenished for the item at the location.
example: 38
task_status:
type: string
description: 'Status of the replenishment task. Allowed values: <code>pending</code>, <code>replenished</code>, <code>completed</code>, and <code>dismissed</code>.'
example: pending
sku:
type: string
description: Stock Keeping Unit (SKU) of the item.
example: HDMI-001
order_multiple:
type: number
format: double
description: Quantity multiple to which the replenishment quantity is rounded off.
example: 5
max_order_quantity:
type: number
format: double
description: Maximum quantity that can be ordered in a single replenishment task.
example: 200
min_order_quantity:
type: number
format: double
description: Minimum quantity that must be ordered in a single replenishment task.
example: 1
order_type:
type: string
description: 'Type of order generated for the replenishment task. Allowed values: <code>purchase_order</code> and <code>transfer_order</code>.'
example: purchase_order
preferred_vendor_id:
type: string
description: Unique ID generated by the server for the preferred vendor.
example: 4815000000009901
preferred_vendor_name:
type: string
description: Name of the preferred vendor.
example: Zylker Supplies
preferred_vendor_status:
type: string
description: Status of the preferred vendor.
example: active
source_location_id:
type: string
description: Unique ID generated by the server for the source location from which stock is replenished.
example: 4815000000034001
source_location_name:
type: string
description: Name of the source location from which stock is replenished.
example: Los Angeles
source_location_status:
type: string
description: Status of the source location.
example: active
source_warehouse_id:
type: string
description: Unique ID generated by the server for the source warehouse from which stock is replenished. Applicable only when multi-warehouse is enabled for the organization.
example: 4815000000038001
source_warehouse_name:
type: string
description: Name of the source warehouse from which stock is replenished. Applicable only when multi-warehouse is enabled for the organization.
example: Los Angeles Warehouse
source_warehouse_status:
type: string
description: Status of the source warehouse. Applicable only when multi-warehouse is enabled for the organization.
example: active
current_stock_available_for_sale:
type: number
format: double
description: Current stock available for sale at the location.
example: 12
current_stock_yet_to_be_received:
type: number
format: double
description: Current stock that has been ordered but is yet to be received at the location.
example: 0
current_stock_in_transit:
type: number
format: double
description: Current stock that is in transit to the location.
example: 0
stock_from_draft_replenishment_purchase_orders:
type: number
format: double
description: Stock from draft replenishment purchase orders for the item at the location.
example: 0
stock_from_draft_replenishment_transfer_orders:
type: number
format: double
description: Stock from draft replenishment transfer orders for the item at the location.
example: 0
is_stock_updated:
type: boolean
description: Indicates whether the stock figures shown for the task reflect the latest available values.
example: true
sort_order:
type: string
description: 'Order in which the records are sorted. Allowed values: <code>A</code> and <code>D</code>.'
example: D
bulk-update-replenishment-configurations-request:
type: object
properties:
replenishment_configurations:
type: array
description: List of replenishment configurations to update. Each entry specifies the values for an item and location (or warehouse) combination.
items:
$ref: '#/components/schemas/create-a-replenishment-configuration-request'
replenishment-configuration-response:
type: object
properties:
replenishment_configuration_id:
type: string
description: Unique ID generated by the server for the replenishment configuration. This is used as an identifier.
example: 4815000000045001
item_id:
type: string
description: Unique ID generated by the server for the item.
example: 4815000000044208
item_name:
type: string
description: Name of the item.
example: HDMI Cable
unit:
type: string
description: Unit of measurement for the item.
example: pcs
item_status:
type: string
description: Status of the item.
example: active
location_id:
type: string
description: Unique ID generated by the server for the location.
example: 4815000000033001
location_name:
type: string
description: Name of the location.
example: New York
# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho-inventory/refs/heads/main/openapi/zoho-inventory-replenishment-api-openapi.yml