---
title: "List all customs items"
method: GET
path: "/customs/items"
tags: ["Customs Items"]
---

# List all customs items

`GET /customs/items`

Returns a list all customs items objects.

## Query parameters

- `page` integer
- `results` integer

## Headers

- `SHIPPO-API-VERSION` string

## Response `200`

Paginated list of customs items

- CustomsItemPaginatedList
  - `next` string
  - `previous` string
  - `results` CustomsItem[]
    - `description` string, required — Text description of your item.
    - `eccn_ear99` string — Export Control Classification Number, required on some exports from the United States.
    - `mass_unit` 'g' | 'kg' | 'lb' | 'oz', required — The unit used for weight.
    - `metadata` string — A string of up to 100 characters that can be filled with any additional information you want to attach to the object.
    - `net_weight` string, required — Total weight of this item, i.e. quantity * weight per item.
    - `origin_country` string, required — Country of origin of the item. Example: `US` or `DE`. All accepted values can be found on the [Official ISO Website](http://www.iso.org/).
    - `quantity` integer, required — Quantity of this item in the shipment you send. Must be greater than 0.
    - `sku_code` string — SKU code of the item, which is required by some carriers.
    - `hs_code` string — HS code of the item, which is required by some carriers. If `tariff_number` is not provided, `hs_code` will be used. If both `hs_code` and `tariff_number` are provided, `tariff_number` will be used. 50 character limit.
    - `tariff_number` string — The tariff number of the item. If `tariff_number` is not provided, `hs_code` will be used. If both `hs_code` and `tariff_number` are provided, `tariff_number` will be used. 12 character limit.
    - `value_amount` string, required — Total value of this item, i.e. quantity * value per item.
    - `value_currency` string, required — Currency used for value_amount. The [official ISO 4217](http://www.xe.com/iso4217.php) currency codes are used, e.g. `USD` or `EUR`.
    - `object_created` string, date-time — Date and time of object creation.
    - `object_id` string — Unique identifier of the given object.
    - `object_owner` string — Username of the user who created the object.
    - `object_state` 'VALID' | 'INVALID' — Indicates the validity of the enclosing object
    - `object_updated` string, date-time — Date and time of last object update.
    - `test` boolean — Indicates whether the object has been created in test mode.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/goshippo/apis/shippo-address-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-address-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-address-api/revisions/26fcc6af452a/schema)