---
title: "list alternatives for a product"
method: GET
path: "/products/{id}/alternatives"
tags: ["Products"]
---

# list alternatives for a product

`GET /products/{id}/alternatives`

## Path parameters

- `id` integer, required

## Query parameters

- `locale` 'nl' | 'en'
- `page` integer
- `per_page` integer
- `detail` 'list' | 'default' | 'health' | 'biz_list' | 'biz'
- `q` string
- `usage_id` integer
- `usage_ids[]` string[]
- `category_id` integer
- `brand_id` integer
- `brand_ids[]` integer[]
- `retailer_id` integer
- `retailer_ids[]` integer[]
- `health_group_id` integer
- `health_group_present` true
- `certificate_id` integer
- `certificate_ids[]` integer[]
- `scored` true
- `personal_health_scored` boolean
- `score` integer
- `nutriscore` 'A' | 'B' | 'C' | 'D' | 'E'
- `nutriscores[]` string[]
- `personal_health_score` 'A' | 'B1' | 'B2' | 'C1' | 'C2'
- `personal_health_scores[]` string[]
- `sort` 'confirmed_at' | 'confirmed_at ASC' | 'name' | 'name DESC' | 'last_updated' | 'last_updated ASC' | 'nutrient_B12' | 'nutrient_B12 DESC' | 'nutrient_calcium' | 'nutrient_calcium DESC' | 'nutrient_energy' | 'nutrient_energy DESC' | 'nutrient_fat_saturated' | 'nutrient_fat_saturated DESC' | 'nutrient_fat_total' | 'nutrient_fat_total DESC' | 'nutrient_fat_trans' | 'nutrient_fat_trans DESC' | 'nutrient_fiber' | 'nutrient_fiber DESC' | 'nutrient_iron' | 'nutrient_iron DESC' | 'nutrient_natrium' | 'nutrient_natrium DESC' | 'nutrient_protein' | 'nutrient_protein DESC' | 'nutrient_salt' | 'nutrient_salt DESC' | 'nutrient_sugar' | 'nutrient_sugar DESC' | 'nutriscore' | 'nutriscore DESC' | 'personal_health_score' | 'personal_health_score DESC' | 'top_certificates_count' | 'top_certificates_count DESC'
- `ids` string
- `image` boolean

## Response `200`

success

- object
  - `products` Product[]
    - `id` integer
    - `name` string — product name
    - `brand_name` string — product brand
    - `nutriscore` 'A' | 'B' | 'C' | 'D' | 'E', nullable — Nutriscore
    - `personal_health_score` 'A' | 'B1' | 'B2' | 'C1' | 'C2', nullable — health score
    - `product_nutrients` ProductNutrient[]
      - `name` string — nutrient name
      - `value` number
      - `unit` string — nutrient unit (unit / per)
    - `usages` SimpleUsage[] — (hierarchical) list of product usages (categories)
      - `id` integer
      - `name` string
    - `certificates` Certificate[]
      - `id` integer
      - `name` string
      - `description` string
      - `image_url` object
        - `thumb` string — url of image thumbnail
      - `themes` string[] — any of 'environment', 'social' and 'animals'
      - `top` boolean — true if the certificate is among selected top certificates, read more about top certificates at https://keurmerken.milieucentraal.nl/wat-zijn-topkeurmerken/.
    - `retailers` Retailer[]
      - `id` integer
      - `name` string
      - `priority` integer, nullable — well-known retailers have a higher priority
    - `image_urls` object[] — product image (0-1 images)
      - `thumb` string — url of image thumbnail
      - `medium` string — url of medium-size image
    - `barcode` string
  - `total` integer — total number of items

## Other responses

- `404` — product not found

---

[API](https://skmtc.net/thequestionmark/apis/questionmark-api-v1-2.md) · [All operations](https://skmtc.net/thequestionmark/apis/questionmark-api-v1-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thequestionmark/questionmark-api-v1-2/versions/936ff09e6fa1/schema)