Zoho Inventory · Schema
Reporting Tags
Reporting tags are custom financial labels you add to financial transactions to categorize them by department, cost center, business unit, or any other way based on business needs for reporting. In this document, you'll learn how to create and manage reporting tags for the specific requirements that your organization needs.
Inventory ManagementWarehousingSales OrdersPurchase OrdersStock AdjustmentShipmentsItemE-Commerce
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Reporting Tags",
"description": "Reporting tags are custom financial labels you add to financial transactions to categorize them by department, cost center, business unit, or any other way based on business needs for reporting. In this document, you'll learn how to create and manage reporting tags for the specific requirements that your organization needs.",
"definitions": {
"is_tag_mandatory": {
"description": "Boolean to check if the tag is mandatory",
"type": "boolean",
"example": false
},
"tags": {
"description": "Array of reporting tags associated with this line item. Each tag consists of a `tag_id` and `option_id` that categorize the line item for reporting and analytics purposes. Tags help organize and filter data across reports and enable detailed business intelligence analysis.",
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_option_id": {
"$ref": "#/components/schemas/option_id"
}
}
}
},
"tags_response": {
"description": "Array of reporting tags associated with this line item in the response. Each tag consists of a `tag_id`, `tag_name`, `option_id`, and `option_name` that categorize the line item for reporting and analytics purposes. Tags help organize and filter data across reports and enable detailed business intelligence analysis.",
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
},
"tag_option_id": {
"$ref": "#/components/schemas/option_id"
},
"tag_option_name": {
"$ref": "#/components/schemas/option_name"
},
"is_tag_mandatory": {
"$ref": "#/components/schemas/is_tag_mandatory"
}
}
}
},
"tag_id": {
"description": "Tag ID",
"type": "string",
"example": "460000000038080"
},
"tag_name": {
"description": "Tag Name",
"type": "string",
"example": "Business Unit"
},
"tag_order": {
"description": "The order in which the tag appears",
"type": "integer",
"example": 1
},
"description": {
"description": "Description",
"type": "string",
"example": "Description of the reporting tag"
},
"is_mandatory": {
"description": "Is Mandatory",
"type": "boolean",
"example": false
},
"is_class": {
"description": "Is segmentation enabled for the tag",
"type": "boolean",
"example": false
},
"is_draft": {
"description": "Is tag still in draft state",
"type": "boolean",
"example": false
},
"option_id": {
"description": "Option ID",
"type": "string",
"example": "460000000038081"
},
"option_name": {
"description": "Option Name",
"type": "string",
"example": "Sales"
},
"depth": {
"description": "Depth or how much indentation required of the option in the hierarchy",
"type": "integer",
"example": 1
},
"filter_tag_id": {
"type": "string",
"description": "Filter tag ID. If the filter 'type' is location, <code>null</code> should be passed",
"example": "460000000038081"
},
"filter_type": {
"description": "Type of filter entity. <br>Allowed values: Tag <code>tag</code> and Location <code>location</code>. <br>",
"type": "string",
"example": "tag"
},
"filter_option_id": {
"description": "Option ID for the filter. It can be an option ID or flags. <br>Allowed flags: <code>all</code> - Instead of selecting all options, you can send this flag to denote all options of the filter tag or location are selected for the filter to the respective tag. <code>untagged</code> - When you want to show an option when no option is selected for the filter tag. <b>Note: This flag cannot be used for location filter.</b>",
"type": "string",
"example": "460000000038081"
},
"filter_option_name": {
"description": "Option Name for the filter. It can be an option name or flags. <br>Allowed flags: <code>All</code> - Instead of selecting all options, you can send this flag to denote all options of the filter tag or location are selected for the filter to the respective tag. <code>Untagged</code> - When you want to show an option when no option is selected for the filter tag. <b>Note: This flag cannot be used for location filter.</b>",
"type": "string",
"example": "Sales"
},
"tag_is_active": {
"type": "boolean",
"description": "Is the tag active",
"example": true
},
"option_is_default": {
"type": "boolean",
"description": "Is the option default for the tag",
"example": true
},
"option_is_active": {
"type": "boolean",
"description": "Is the option active for the tag",
"example": true
},
"entities": {
"description": "Entities that can only be enabled or disabled which can also be called as mono-preference entities.",
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_name": {
"description": "Entity Name<br>Possible Values: <br>Customer - <code>customers</code>, <br>Vendor - <code>vendors</code>, <br>Item - <code>items</code>",
"type": "string",
"enum": [
"customers",
"vendors",
"items"
]
},
"is_enabled": {
"description": "Is Enabled",
"type": "boolean",
"example": true
}
}
},
"example": [
{
"entity_name": "customers",
"is_enabled": true
},
{
"entity_name": "vendors",
"is_enabled": true
},
{
"entity_name": "items",
"is_enabled": true
}
]
},
"multi_preference_entities": {
"type": "object",
"properties": {
"preference": {
"description": "Preference type. Currently, only <code>'transaction' and 'line_item'</code> is supported for this node",
"type": "string",
"example": "line_item"
},
"entities": {
"description": "Entities that can only be enabled or disabled",
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_name": {
"description": "Entity Name. Possible Values: <br>Sales - <code>sales</code>, <br>Purchases - <code>purchases</code>, <br>Inventory Adjustment - <code>inventory_adjustment</code>",
"type": "string",
"enum": [
"Sales",
"Purchases",
"Inventory Adjustment"
]
},
"is_enabled": {
"description": "Is Enabled",
"type": "boolean",
"example": true
}
}
}
}
},
"example": {
"preference": "line_item",
"entities": [
{
"entity_name": "sales",
"is_enabled": true
},
{
"entity_name": "purchases",
"is_enabled": true
},
{
"entity_name": "inventory_adjustment",
"is_enabled": true
}
]
}
},
"criteria_tags": {
"description": "Filter tags and location",
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/filter_tag_id"
},
"type": {
"$ref": "#/components/schemas/filter_type"
}
}
}
},
"criteria_options": {
"description": "Options for criteria",
"type": "array",
"items": {
"type": "object",
"properties": {
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"criteria_options": {
"description": "List containing filter tags and location",
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/filter_tag_id"
},
"type": {
"$ref": "#/components/schemas/filter_type"
},
"options": {
"description": "Options selected for the criteria",
"type": "array",
"items": {
"$ref": "#/components/schemas/option_id"
}
}
}
}
}
}
}
},
"tag_response": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
},
"description": {
"$ref": "#/components/schemas/description"
},
"is_mandatory": {
"$ref": "#/components/schemas/is_mandatory"
},
"entities": {
"$ref": "#/components/schemas/entities"
},
"multi_preference_entities": {
"$ref": "#/components/schemas/multi_preference_entities"
}
}
},
"list-reporting-tags-response": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
},
"tag_order": {
"$ref": "#/components/schemas/tag_order"
},
"description": {
"$ref": "#/components/schemas/description"
},
"is_active": {
"$ref": "#/components/schemas/tag_is_active"
},
"is_mandatory": {
"$ref": "#/components/schemas/is_mandatory"
},
"is_class": {
"$ref": "#/components/schemas/is_class"
},
"is_draft": {
"$ref": "#/components/schemas/is_draft"
}
}
},
"example": [
{
"tag_id": "460000000038080",
"tag_name": "Business Unit",
"tag_order": 1,
"description": "Description of the reporting tag",
"is_active": true,
"is_mandatory": false,
"is_class": false,
"is_draft": false
},
{
"tag_id": "460000000038081",
"tag_name": "Sales Region",
"tag_order": 2,
"description": "Description of the reporting tag",
"is_active": true,
"is_mandatory": false,
"is_class": true,
"is_draft": false
},
{
"tag_id": "460000000038082",
"tag_name": "Department",
"tag_order": 3,
"description": "Description of the reporting tag",
"is_active": false,
"is_mandatory": true,
"is_class": false,
"is_draft": true
}
]
},
"update-reporting-tag-request": {
"required": [
"tag_name",
"entities",
"multi_preference_entities"
],
"type": "object",
"properties": {
"tag_name": {
"$ref": "#/components/schemas/tag_name"
},
"description": {
"$ref": "#/components/schemas/description"
},
"is_mandatory": {
"$ref": "#/components/schemas/is_mandatory"
},
"entities": {
"$ref": "#/components/schemas/entities"
},
"multi_preference_entities": {
"$ref": "#/components/schemas/multi_preference_entities"
}
}
},
"update-options-request": {
"required": [
"options"
],
"type": "object",
"properties": {
"options": {
"type": "array",
"description": "Options selected for the criteria",
"items": {
"type": "object",
"properties": {
"option_name": {
"$ref": "#/components/schemas/option_name"
},
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
},
"children": {
"type": "array",
"description": "Child options of the option.",
"items": {
"type": "object",
"properties": {
"option_id": {
"description": "Option ID",
"type": "string",
"example": "460000000038082"
},
"option_name": {
"description": "Option Name",
"type": "string",
"example": "Sales - East"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
}
}
}
}
}
}
}
},
"example": {
"options": [
{
"option_id": "460000000038082",
"option_name": "ES-2003",
"is_active": true,
"is_default": true,
"children": [
{
"option_id": "460000000038088",
"children": [],
"option_name": "ES-2003 Sec - B",
"is_active": true
},
{
"option_name": "ES-2003 Sec - C",
"is_active": true,
"children": [
{
"children": [],
"option_name": "EES-2003",
"is_active": true
}
]
}
]
},
{
"option_id": "460000000038084",
"option_name": "ES-N-2016",
"is_active": true,
"is_default": false,
"children": []
},
{
"option_id": "460000000038086",
"option_name": "HS & ES-N",
"is_active": true,
"is_default": false,
"children": []
}
]
}
},
"update-options-response": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Options updated successfully"
}
}
},
"reporting-tags-response": {
"type": "object",
"properties": {
"tag": {
"$ref": "#/components/schemas/tag_response"
}
}
},
"update-criteria-request": {
"required": [
"criteria_tags",
"options"
],
"type": "object",
"properties": {
"criteria_tags": {
"$ref": "#/components/schemas/criteria_tags"
},
"options": {
"$ref": "#/components/schemas/criteria_options"
}
}
},
"update-criteria-response": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "The criteria has been updated."
}
}
},
"update-segmentation-response": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Segmentation modified successfully."
}
}
},
"options-editpage-response": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "success"
},
"is_class": {
"$ref": "#/components/schemas/is_class"
},
"is_draft": {
"$ref": "#/components/schemas/is_draft"
},
"is_filter_configured": {
"type": "boolean",
"description": "If filter is configured for this tag, it will be <code>true</code>",
"example": true
},
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
},
"options": {
"type": "array",
"description": "Options selected for the criteria",
"items": {
"type": "object",
"properties": {
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"option_name": {
"$ref": "#/components/schemas/option_name"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
},
"children": {
"type": "array",
"description": "Child options of the option.",
"items": {
"type": "object",
"properties": {
"option_id": {
"description": "Option ID",
"type": "string",
"example": "460000000038082"
},
"option_name": {
"description": "Option Name",
"type": "string",
"example": "Sales - East"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
}
}
}
}
}
}
}
}
},
"editpage-segmentation-response": {
"type": "object",
"properties": {
"is_class": {
"$ref": "#/components/schemas/is_class"
},
"is_draft": {
"$ref": "#/components/schemas/is_draft"
},
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
}
}
},
"dependent_tags": {
"type": "array",
"description": "The tags and location that is associated as filter for the tag",
"items": {
"type": "object",
"properties": {
"dependent_id": {
"type": "string",
"description": "Dependent Tag's ID. If the dependent is location, value will be empty",
"example": 460000000038081
},
"dependent_name": {
"type": "string",
"description": "Dependent Tag's Name. If the dependent is location, value will be <code>Location</code>",
"example": "Sales"
},
"dependent_order": {
"type": "integer",
"description": "The order in which the dependent tags appear. If the dependent is location, value will be empty",
"example": 1
},
"dependent_type": {
"type": "string",
"description": "Type of the dependent. Allowed values: Tag <code>tag</code>, Location <code>location</code>",
"example": "tag"
},
"dependent_options": {
"description": "Options selected for the dependent tag. If the dependent is location, this will be empty",
"type": "array",
"items": {
"type": "object",
"properties": {
"dependent_option_id": {
"type": "string",
"description": "Dependent Option ID",
"example": 460000000038083
},
"dependent_option_name": {
"type": "string",
"description": "Dependent Option Name",
"example": "Sales - East"
},
"dependent_option_order": {
"type": "integer",
"description": "The order in which the options appear.",
"example": 1
}
}
}
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
}
}
}
},
"possible_filter_tags": {
"description": "List of tags that can be used as filter for the tag",
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"$ref": "#/components/schemas/tag_id"
},
"tag_name": {
"$ref": "#/components/schemas/tag_name"
},
"type": {
"type": "string",
"description": "Type of the tag. Allowed values: Tag <code>tag</code>, Location <code>location</code>",
"example": "tag"
},
"is_associated": {
"type": "boolean",
"description": "Indicates whether the tag is already associated as filter for the tag",
"example": true
},
"is_restricted": {
"type": "boolean",
"description": "Indicates whether the tag is restricted to be used as filter for the tag",
"example": false
},
"restricted_reason": {
"type": "string",
"description": "Reason for restriction, if any",
"example": "The modules associated with this reporting tag are not set at the appropriate level compared to the current tag. Kindly refer to the requirements for a filter tag."
}
}
}
},
"criteria_options_response": {
"type": "array",
"description": "Options selected for the criteria",
"items": {
"type": "object",
"properties": {
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"option_name": {
"$ref": "#/components/schemas/option_name"
},
"option_order": {
"type": "integer",
"description": "The order in which the options appear.",
"example": 1
},
"parent_id": {
"type": "string",
"description": "Parent Option ID. If the options does not have a parent, this will be empty",
"example": "460000000038081"
},
"parent_name": {
"type": "string",
"description": "Parent Option Name. If the options does not have a parent, this will be empty",
"example": "Sales"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
},
"criteria": {
"type": "object",
"properties": {
"criteria_id": {
"type": "string",
"description": "Filter ID",
"example": "460000000038084"
},
"tag_id": {
"$ref": "#/components/schemas/filter_tag_id"
},
"type": {
"$ref": "#/components/schemas/filter_type"
},
"options": {
"description": "Options selected for the criteria",
"type": "array",
"items": {
"$ref": "#/components/schemas/filter_option_id"
}
}
}
},
"children": {
"description": "Child options of the option",
"type": "array",
"items": {
"type": "object",
"properties": {
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"option_name": {
"$ref": "#/components/schemas/option_name"
},
"option_order": {
"type": "integer",
"description": "The order in which the options appear.",
"example": 1
},
"parent_id": {
"type": "string",
"description": "Parent Option ID. If the options does not have a parent, this will be empty",
"example": "460000000038081"
},
"parent_name": {
"type": "string",
"description": "Parent Option Name. If the options does not have a parent, this will be empty",
"example": "Sales"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
},
"criteria": {
"type": "object",
"properties": {
"criteria_id": {
"type": "string",
"description": "Filter ID",
"example": "460000000038084"
},
"tag_id": {
"$ref": "#/components/schemas/filter_tag_id"
},
"type": {
"$ref": "#/components/schemas/filter_type"
},
"options": {
"description": "Options selected for the criteria",
"type": "array",
"items": {
"$ref": "#/components/schemas/filter_option_id"
}
}
}
}
}
}
}
}
}
},
"criteria_options_response_for_details_page": {
"type": "array",
"description": "Options selected for the criteria",
"items": {
"type": "object",
"properties": {
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"option_name": {
"$ref": "#/components/schemas/option_name"
},
"option_order": {
"type": "integer",
"description": "The order in which the options appear.",
"example": 1
},
"parent_id": {
"type": "string",
"description": "Parent Option ID. If the options does not have a parent, this will be empty",
"example": "460000000038081"
},
"parent_name": {
"type": "string",
"description": "Parent Option Name. If the options does not have a parent, this will be empty",
"example": "Sales"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
},
"criteria": {
"type": "object",
"properties": {
"criteria_id": {
"type": "string",
"description": "Filter ID",
"example": "460000000038084"
},
"tag_id": {
"$ref": "#/components/schemas/filter_tag_id"
},
"type": {
"$ref": "#/components/schemas/filter_type"
},
"options": {
"description": "Options selected for the criteria",
"type": "array",
"items": {
"$ref": "#/components/schemas/filter_option_name"
}
}
}
},
"children": {
"description": "Child options of the option",
"type": "array",
"items": {
"type": "object",
"properties": {
"option_id": {
"$ref": "#/components/schemas/option_id"
},
"option_name": {
"$ref": "#/components/schemas/option_name"
},
"option_order": {
"type": "integer",
"description": "The order in which the options appear.",
"example": 1
},
"parent_id": {
"type": "string",
"description": "Parent Option ID. If the options does not have a parent, this will be empty",
"example": "460000000038081"
},
"parent_name": {
"type": "string",
"description": "Parent Option Name. If the options does not have a parent, this will be empty",
"example": "Sales"
},
"is_active": {
"$ref": "#/components/schemas/option_is_active"
},
"is_default": {
"$ref": "#/components/schemas/option_is_default"
},
"criteria": {
"type": "object",
"properties": {
"criteria_id": {
"type": "string",
"description": "Filter ID",
"example": "460000000038084"
},
"tag_id": {
"$ref": "#/components/schemas/filter_tag_id"
},
"type": {
"$ref": "#/components/schemas/filter_type"
},
"options": {
"description": "Options selected for the criteria",
"type": "array",
"items": {
"$ref": "#/components/schemas/filter_option_id"
}
}
}
}
}
}
}
}
},
"example": [
{
"option_id": "460000000038081",
"option_name": "Sales",
"is_active": true,
"is_default": false,
"depth": 0,
"option_order": 1,
"parent_id": "",
"parent_name": "",
"criteria": [
{
"options": [
"Asia",
"India",
"Europe"
],
"criteria_id": "460000000048081",
"tag_id": "",
"type": "location"
},
{
"options": [
"Untagged",
"Government",
"Military / Defense"
],
"criteria_id": "460000000048083",
"tag_id": "460000000038078",
"type": "tag"
}
],
"children": [
{
"option_id": "460000000038083",
"option_name": "Sales - Central",
"children": [],
"is_active": true,
"is_default": false,
"depth": 0,
"option_order": 2,
"parent_id": "",
"parent_name": "",
"criteria": [
{
"options": [
"Asia",
"North America"
],
"criteria_id": "460000000048081",
"tag_id": "",
"type": "location"
},
{
"options": [
"All"
],
"criteria_id": "460000000048083",
"tag_id": "460000000038078",
"type": "tag"
}
]
}
]
}
]
},
"editpage-criteria-
# --- truncated at 32 KB (43 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho-inventory/refs/heads/main/json-schema/reporting-tags.json
Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/reporting-tags"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.