---
title: "get ranking by id"
method: GET
path: "/rankings/{id}"
tags: ["Rankings"]
---

# get ranking by id

`GET /rankings/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `locale` 'nl' | 'en'
- `preview_token` string

## Response `200`

success

- Ranking
  - `id` integer
  - `title` string
  - `intro` string
  - `disclaimer` string
  - `cover_image_url` object
    - `medium` string — url of medium-size cover image
    - `large` string — url of full-size cover image
  - `sharing_image_url` string — url of image used for social sharing (like an opengraph tag)
  - `updated_on` string, date — last published date (or last updated for preview)
  - `renews` RankingForList
    - `id` integer
    - `title` string
    - `cover_image_url` object
      - `medium` string — url of medium-size cover image
      - `large` string — url of full-size cover image
    - `updated_on` string, date — last published date (or last updated for preview)
    - `renews` unknown
  - `weights` object[] — topics used in the ranking with their weights
    - `title` string
    - `value` number — weight (0-1)
    - `theme` string
  - `ranking_items` RankingProduct[] — products in the ranking (best first)
    - `id` integer — product id
    - `name` string — product name
    - `image_urls` object[] — product image (0-1 images)
      - `thumb` string — url of image thumbnail
      - `medium` string — url of medium-size image
    - `position` integer — position in the ranking
    - `position_class` 'front' | 'middle' | 'back' — to which ranking group the product belongs
    - `sustainability` object
      - `score` integer — sustainability score (0-5)
      - `best` boolean — whether this product has the best sustainability score
      - `text` string — explanation of the sustainability score (HTML)
    - `health` object
      - `score` integer — health score (0-5)
      - `best` boolean — whether this product has the best health score
      - `text` string — explanation of the health score (HTML, often not present)
      - `product_nutrients` ProductNutrient[]
        - `name` string — nutrient name
        - `value` number
        - `unit` string — nutrient unit (unit / per)
    - `brand` Brand
      - `id` integer
      - `name` string
    - `top_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/.
  - `reactions` RankingReaction[] — reactions from producers
    - `text` string
    - `author` string

## Other responses

- `404` — ranking not found

---

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