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

# GET /api/v1/users

`GET /api/v1/users`

## Request

- Base URL: `https://prices.openfoodfacts.org` (the document declares no server; this is the origin it was published from)
- URL: `https://prices.openfoodfacts.org/api/v1/users`
- Auth: none declared

## Query parameters

- `order_by` string
- `page` integer
- `price_count` integer
- `price_count__gte` integer
- `price_count__lte` integer
- `size` integer

## Response `200`

- PaginatedUserList
  - `items` User[], required
    - `user_id` string, required
    - `price_count` integer
    - `price_type_product_count` integer
    - `price_type_category_count` integer
    - `price_kind_community_count` integer
    - `price_kind_consumption_count` integer
    - `price_in_proof_owned_count` integer
    - `price_in_proof_not_owned_count` integer
    - `price_not_owned_in_proof_owned_count` integer
    - `proof_count` integer
    - `proof_type_price_tag_count` integer
    - `proof_type_receipt_count` integer
    - `proof_type_gdpr_request_count` integer
    - `proof_type_shop_import_count` integer
    - `proof_kind_community_count` integer
    - `proof_kind_consumption_count` integer
    - `location_count` integer
    - `location_type_osm_city_count` integer
    - `location_type_osm_country_count` integer
    - `product_count` integer
    - `badge_count` integer
    - `currency_count` integer
    - `year_count` integer
    - `challenge_count` integer
  - `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

## Changes

- **2026-08-22** `2315a270e4e6`: 5 info
  - added the optional property `items/items/location_type_osm_city_count` to the response with the `200` status
  - added the optional property `items/items/proof_type_gdpr_request_count` to the response with the `200` status
  - added the optional property `items/items/proof_type_price_tag_count` to the response with the `200` status
  - added the optional property `items/items/proof_type_receipt_count` to the response with the `200` status
  - …1 more
- **2026-07-13** `f1bb01adae9b`: 1 breaking, 19 info
  - the `items/items/` response's property type changed from `array` to `object` for status `200`
  - added the optional property `items/items/badge_count` to the response with the `200` status
  - added the optional property `items/items/challenge_count` to the response with the `200` status
  - added the optional property `items/items/currency_count` to the response with the `200` status
  - …16 more

[Operation history](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api/changes/api/v1/users/get.md)

---

[API](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api.md) - [All operations](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-prices-rest-api/revisions/d7c5d8b4c32e?raw)