---
title: "List all Item Categories"
method: GET
path: "/2024-09/item_categories"
tags: ["Item Categories"]
---

# List all Item Categories

`GET /2024-09/item_categories`

## Request

- Base URL: `https://public-api.easyship.com`
- URL: `https://public-api.easyship.com/2024-09/item_categories`
- Auth: HTTP bearer

Retrieve a list of item categories.

Required authorization scope: `public.reference:read`

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

list of item categories

- ItemCategoryList: List of item categories
  - `item_categories` ItemCategory[]
    - `id` integer: Item Category ID
    - `name` string
    - `hs_code` string: HS Code of the item
    - `slug` string
    - `active` boolean: Item Category state
    - `includes_battery` boolean: Whether the item includes batteries.
    - `contains_liquids` boolean: Whether the item contains liquids.
    - `contains_battery_pi966` boolean: Whether the item contains a PI966 battery.
    - `contains_battery_pi967` boolean: Whether the item contains a PI967 battery.
  - `meta` MetaWithPagination
    - `pagination` Pagination: Pagination
      - `next` integer, nullable
      - `count` integer, nullable: The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer: Current page
    - `request_id` string: An unique ID represent the request.

---

[API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-public-api/revisions/b47b54b748a7?raw)