---
title: "searchCatalogItems"
method: GET
path: "/catalog/2022-04-01/items"
tags: ["Catalog Items v2022-04-01"]
---

# searchCatalogItems

`GET /catalog/2022-04-01/items`

Search for a list of Amazon catalog items and item-related information. You can search by identifier or by keywords.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 2 | 2 |

The `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

> ❗️ To view the response
>
> The response to this operation cannot be displayed in this reference because of technical issues. For this operation's response schema, refer to [`searchCatalogItems`](https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2022-04-01-reference#searchcatalogitems).

## Query parameters

- `identifiers` string[]
- `identifiersType` 'ASIN' | 'EAN' | 'GTIN' | 'ISBN' | 'JAN' | 'MINSAN' | 'SKU' | 'UPC'
- `marketplaceIds` string[], required
- `includedData` string[]
- `locale` string
- `sellerId` string
- `keywords` string[]
- `brandNames` string[]
- `classificationIds` string[]
- `pageSize` integer
- `pageToken` string
- `keywordsLocale` string

## Response `200`

Success.

- ItemSearchResults — Selling partner listings items and search related metadata.
  - `numberOfResults` integer, required — The total number of selling partner listings items found for the search criteria (only results up to the page count limit is returned per request regardless of the number found). Note: The maximum number of items (SKUs) that can be returned and paged through is 1000.
  - `pagination` Pagination — The pagination elements required to retrieve the remaining data.
    - `nextToken` string — A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to the next request. If NextToken is not returned, there are no more shipment items to return.
  - `items` Item[], required — A list of listings items.
    - `itemSequenceNumber` string, required — Item sequence number for the item. The first item will be 001, the second 002, and so on. This number is used as a reference to refer to this item from the carton or pallet level.
    - `amazonProductIdentifier` string — Buyer Standard Identification Number (ASIN) of an item.
    - `vendorProductIdentifier` string — The vendor selected product identification of the item. Should be the same as was sent in the purchase order.
    - `shippedQuantity` ItemQuantity, required — Details of item quantity.
      - `amount` integer, required — Amount of units shipped for a specific item at a shipment level. If the item is present only in certain cartons or pallets within the shipment, please provide this at the appropriate carton or pallet level.
      - `unitOfMeasure` 'Cases' | 'Eaches', required — Unit of measure for the shipped quantity.
      - `unitSize` integer — The case size, in the event that we ordered using cases. Otherwise, 1.
      - `totalWeight` TotalWeight — The total weight of units that are sold by weight in a shipment.
        - `unitOfMeasure` 'POUNDS' | 'OUNCES' | 'GRAMS' | 'KILOGRAMS', required — The unit of measure for the weight of items that are ordered by cases and support pricing by weight.
        - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
    - `itemDetails` ItemDetails — Item details for be provided for every item in shipment at either the item or carton or pallet level, whichever is appropriate.
      - `purchaseOrderNumber` string — The purchase order number for the shipment being confirmed. If the items in this shipment belong to multiple purchase order numbers that are in particular carton or pallet within the shipment, then provide the purchaseOrderNumber at the appropriate carton or pallet level. Formatting Notes: 8-character alpha-numeric code.
      - `lotNumber` string — The batch or lot number associates an item with information the manufacturer considers relevant for traceability of the trade item to which the Element String is applied. The data may refer to the trade item itself or to items contained. This field is mandatory for all perishable items.
      - `lotNumberSourceReference` string — The location identifier where the product receives a traceability lot number. Provide this field for products subject to the FDA Food Safety Modernization Act (FSMA) Section 204. When you provide `lotNumberSourceReference`, you must also specify the corresponding `lotNumberSourceType` field.
      - `lotNumberSourceType` 'GLN' | 'FFRN' | 'USDA_E' | 'URL' — The identifier type used for the lot number source. Provide this field when you specify `lotNumberSourceReference`.
      - `countryOfOrigin` string — The two-character country code for the country where the product was manufactured or originates. Use ISO 3166-1 alpha-2 format.
      - `regulationReferences` RegulationReferences — Regulatory requirements and compliance information for the item, including reference numbers, verification codes, and exemption codes. Use this field to specify applicable regulations such as EU Deforestation Regulation (EUDR).
        - `dueDiligenceReference` string — The reference number from the vendor's EUDR Due Diligence Statement (DDS) submitted to the EU Commission portal or provided to Amazon through ONIX feed.
        - `dueDiligenceVerification` string — The EUDR Due Diligence verification number provided by the EU Commission for the submitted DDS.
        - `dueDiligenceInformation` string — The EUDR Due Diligence information pre-loaded in Vendor Central.
        - `dueDiligenceExemptionCode` string — The exemption code for EUDR products exempt from due diligence requirements.
      - `expiry` Expiry — Expiry refers to the collection of dates required for certain items. These could be either expiryDate or mfgDate and expiryAfterDuration. These are mandatory for perishable items.
        - `manufacturerDate` string, date-time — Production, packaging or assembly date determined by the manufacturer. Its meaning is determined based on the trade item context.
        - `expiryDate` string, date-time — The date that determines the limit of consumption or use of a product. Its meaning is determined based on the trade item context.
        - `expiryAfterDuration` Duration — Duration after manufacturing date during which the product is valid for consumption.
          - `durationUnit` 'Days' | 'Months', required — Unit for duration.
          - `durationValue` integer, required — Value for the duration in terms of the durationUnit.
      - `maximumRetailPrice` Money — An amount of money, including units in the form of currency.
        - `currencyCode` string, required — Three digit currency code in ISO 4217 format.
        - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
      - `handlingCode` 'Oversized' | 'Fragile' | 'Food' | 'HandleWithCare' — Identification of the instructions on how specified item/carton/pallet should be handled.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)