List items

GET

/items

Get the list of all active items with pagination.

Request

Authorization

OAuth 2.0

Implicit

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://accounts.zoho.com/oauth/v2/auth

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/items?name=Hard Drive&description=500GB&rate=120&tax_id=982000000037049&tax_name=Sales Tax&is_taxable&tax_exemption_id=&account_id=&filter_by=&search_text=&sort_column=&sat_item_key_code=&unitkey_code=&page=1&per_page=200'

Response Example

{
    "code": 0,
    "message": "success",
    "items": [
        {
            "item_id": 460000000000108,
            "name": "Hard Drive",
            "status": "active",
            "description": "The New York State Department of  Taxation and Finance",
            "rate": 1.23,
            "unit": "100GB",
            "tax_id": "982000000566009",
            "purchase_tax_rule_id": 127919000000106780,
            "sales_tax_rule_id": 127919000000106780,
            "tax_name": "Sales Group",
            "tax_percentage": 10.5,
            "tax_type": "tax",
            "sku": "s12345",
            "product_type": "goods",
            "sat_item_key_code": "string",
            "unitkey_code": "string",
            "custom_fields": [
                {
                    "customfield_id": "46000000012845",
                    "value": "Normal"
                }
            ]
        }
    ],
    "page_context": {
        "page": 1,
        "per_page": 200,
        "has_more_page": false,
        "report_name": "Taxes",
        "sort_column": "created_time",
        "sort_order": "D"
    }
}

Modified at 2025-10-12 16:28:37

Create an Item

Update an item using a custom field's unique value