Item.Get

Returns all current register products, including locally created products and products added through other integrations. Deleted products are excluded. Each product appears once.

Pass the integration Bearer token in the HTTP header. See API authentication.

Input parameters

Name Data type Required Description
page int32 Optional Page starting at 1; default 1
page_size int32 Optional 1–30; default 30

An object params is required; {} selects the first page. Results are ordered by ascending item_id. The result contains page, page_size, total (all available products) and items. Pages beyond the list return an empty array. Catalog changes between calls can shift pages. Current catalog prices do not overwrite existing cart snapshots.

Request example

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8
{
    "jsonrpc": "2.0",
    "method": "Item.Get",
    "params": {
        "page": 1,
        "page_size": 30
    },
    "id": 1
}

Output parameters

Name Data type Description
page int32 Current page, starting at 1
page_size int32 Page size, from 1 to 30
total int64 Count of all available products
items array Products
items[].external_id string Shared external key; empty if none is assigned or a legacy collision is unresolved
items[].item_id int64 Local product ID for Cart.Add
items[].name string Product name
items[].barcode string Barcode; empty if absent
items[].price int64 Unit price in tiyin
items[].vat_value int64 or null VAT in hundredths of a percent; -1 means no VAT; null means unavailable
items[].icps string ICPS code
items[].package_code string or null Package code; null if absent
items[].unit_kkm_code int64 Unit code
items[].owner_type int32 -1 — unspecified; 0 — resale; 1 — production; 2 — services
items[].is_labeled boolean Marked product flag
items[].label_required boolean or null Required marking; null falls back to is_labeled

Response example

{
    "jsonrpc": "2.0",
    "result": {
        "page": 1,
        "page_size": 30,
        "total": 1,
        "items": [
            {
                "external_id": "SKU-001",
                "item_id": 101,
                "name": "Test product",
                "barcode": "4780000000000",
                "price": 10000,
                "vat_value": 0,
                "icps": "00000000000000000",
                "package_code": null,
                "unit_kkm_code": 1,
                "owner_type": 0,
                "is_labeled": false,
                "label_required": null
            }
        ]
    },
    "ok": true,
    "id": 1
}

Repeated calls do not change products. Errors: common errors; 701003 for invalid pagination.