---
title: "List HS Codes"
method: GET
path: "/2024-09/hs_codes"
tags: ["HS codes"]
---

# List HS Codes

`GET /2024-09/hs_codes`

Retrieve a list of HS codes.

Required authorization scope: `public.hs_code:read`

**Rate limit**: This endpoint is rate-limited by 100 requests per second, 1,000 requests per minute, 1,000 requests per hour, 1,000 requests per day, and 30,000 requests per month.
Exceeding this limit returns a `429 Too Many Requests` response for subsequent requests. If you need a higher rate limit, get in touch with us.

> **Note:** This endpoint requires an **advanced scope**. You can enable advanced scopes when creating or editing your [API connection](https://developers.easyship.com/reference/scopes).

Calls to this endpoint count towards your API usage allowance. You can monitor your current usage in the [Subscription section](https://app.easyship.com/account/subscription) of your account.

## Query parameters

- `page` integer
- `per_page` integer
- `code` string
- `description` string

## Response `200`

list of hs codes

- HsCodeList — List of HS codes
  - `hs_codes` HSCode[]
    - `description` string, required — Description of the HS code
    - `code` string, required — HS code
  - `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.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)