Skip to main content

products

Searches the product catalog and returns a paginated list of products. Results can be filtered by product id, national code or EAN. When no filter is provided, all available products are returned page by page.

How to use this endpoint:

  • In order to retrieve information about the products, the HTTP header "locale" must be added to the request with the value "de_DE".
info

The maximum number of rows per page is 60.

products(
  productIds: [String!]
  productNationalCodes: [NationalCodeInput!]
  productEans: [String!]
  searchByCursor: Boolean
  nextCursor: String
  updatedAtFrom: String
): PaginatedProducts

Arguments​

products.productIds ● [String!] list scalar​

Product ids to fetch (UUIDs).

products.productNationalCodes ● [NationalCodeInput!] list input​

Filters products by their national codes.

Example (json):

[
  { "code": "45409790", "country": "DE" }
]

products.productEans ● [String!] list scalar​

Filters products by their EANs.

products.searchByCursor ● Boolean scalar​

Enables cursor-based pagination. Set to true on the first request to start paginating by cursor. When omitted, cursor pagination is disabled.

products.nextCursor ● String scalar​

The cursor pointing to the next page of results. Leave empty on the first request and, for subsequent requests, pass the nextCursor value returned in the previous response's metadata.

products.updatedAtFrom ● String scalar​

Filters products modified on or after the given date (ISO 8601, e.g. "2026-07-28").

Type​

PaginatedProducts object​

A paginated collection of products.