---
title: "Get a list of EUDR related HS Codes"
method: GET
path: "/public/v2/eudr/shared/hscodes"
tags: ["EUDR - Shared"]
---

# Get a list of EUDR related HS Codes

`GET /public/v2/eudr/shared/hscodes`

Retrieve a list of Harmonized System (HS) codes relevant for EUDR compliance.

This endpoint returns reference data containing all HS codes that are applicable for EUDR products.
HS codes are used to classify products for customs and compliance purposes. Each entry includes
the code, description, and linked commodity ID when available.

**Use Cases**:
- Get HS code reference data for products
- Populate HS code selection dropdowns
- Validate product classifications

**Required permissions (one of):** `access_public_products` or `access_public_eudr_suppliers`

## Response `200`

List of EUDR-related HS codes.

- PublicProductHSCode[]
  - `code` string, required — HS code
  - `description` string, nullable — HS code description
  - `commodityId` integer, nullable — Commodity ID for the HS code

## Other responses

- `403` — 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)