---
title: "GET /api/v1/badges"
method: GET
path: "/api/v1/badges"
tags: ["badges"]
---

# GET /api/v1/badges

`GET /api/v1/badges`

## Query parameters

- `order_by` string
- `page` integer
- `size` integer

## Response `200`

- PaginatedBadgeList
  - `items` Badge[], required
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `image_url` string, uri, nullable
    - `metric` 'price_count' | 'price_in_proof_not_owned_count' | 'proof_count' | 'proof_type_price_tag_count' | 'proof_type_receipt_count' | 'proof_type_gdpr_request_count' | 'proof_type_shop_import_count' | 'location_count' | 'location_type_osm_city_count' | 'location_type_osm_country_count' | 'currency_count' | 'year_count' | 'challenge_count', required — * `price_count` - price_count * `price_in_proof_not_owned_count` - price_in_proof_not_owned_count * `proof_count` - proof_count * `proof_type_price_tag_count` - proof_type_price_tag_count * `proof_type_receipt_count` - proof_type_receipt_count * `proof_type_gdpr_request_count` - proof_type_gdpr_request_count * `proof_type_shop_import_count` - proof_type_shop_import_count * `location_count` - location_count * `location_type_osm_city_count` - location_type_osm_city_count * `location_type_osm_country_count` - location_type_osm_country_count * `currency_count` - currency_count * `year_count` - year_count * `challenge_count` - challenge_count
    - `threshold` integer, required
    - `user_count` integer
    - `created` string, date-time
    - `updated` string, date-time, required
  - `page` integer, required — Current page number
  - `pages` integer, required — Total number of pages
  - `size` integer, required — Number of items per page
  - `total` integer, required — Total number of items

---

[API](https://skmtc.net/openfoodfacts/apis/open-food-facts-open-prices-rest-api.md) · [All operations](https://skmtc.net/openfoodfacts/apis/open-food-facts-open-prices-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openfoodfacts/open-food-facts-open-prices-rest-api/revisions/2315a270e4e6/schema)