# Open Prices API

**Canonical:** https://apis.io/apis/open-food-facts/open-food-facts-open-prices/  
**Provider:** Open Food Facts — https://apis.io/providers/open-food-facts/  
**Base URL:** https://prices.openfoodfacts.org  
**Documentation:** https://prices.openfoodfacts.org/api/docs

Open Prices API is one of 12 APIs that [Open Food Facts](https://apis.io/providers/open-food-facts/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Prices and Retail. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Open Prices is Open Food Facts' open crowdsourced database of product prices. Its REST API covers prices, proofs, locations, products, users and stats, and serves its own OpenAPI 3.0.3 document from the live host.

## Operations (60 of 61)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/schema` | — |
| POST | `/api/v1/auth` | — |
| GET | `/api/v1/badges` | — |
| GET | `/api/v1/badges/{id}` | — |
| GET | `/api/v1/badges/{id}/users` | — |
| GET | `/api/v1/challenges` | — |
| GET | `/api/v1/challenges/{id}` | — |
| GET | `/api/v1/flags` | — |
| PATCH | `/api/v1/flags/{id}` | — |
| GET | `/api/v1/locations` | — |
| POST | `/api/v1/locations` | — |
| GET | `/api/v1/locations/{id}` | — |
| GET | `/api/v1/locations/compare` | — |
| GET | `/api/v1/locations/nearby` | — |
| GET | `/api/v1/locations/osm/{osm_type}/{osm_id}` | — |
| GET | `/api/v1/locations/osm/countries` | — |
| GET | `/api/v1/locations/osm/countries/{country_code}/cities` | — |
| GET | `/api/v1/price-tags` | — |
| POST | `/api/v1/price-tags` | — |
| GET | `/api/v1/price-tags/{id}` | — |
| PATCH | `/api/v1/price-tags/{id}` | — |
| DELETE | `/api/v1/price-tags/{id}` | — |
| GET | `/api/v1/prices` | — |
| POST | `/api/v1/prices` | — |
| GET | `/api/v1/prices/{id}` | — |
| PATCH | `/api/v1/prices/{id}` | — |
| DELETE | `/api/v1/prices/{id}` | — |
| POST | `/api/v1/prices/{id}/flag` | — |
| GET | `/api/v1/prices/{id}/history` | — |
| GET | `/api/v1/prices/stats` | — |
| GET | `/api/v1/products` | — |
| GET | `/api/v1/products/{id}` | — |
| GET | `/api/v1/products/code/{code}` | — |
| PATCH | `/api/v1/products/code/{code}/off-update` | — |
| PATCH | `/api/v1/products/code/{code}/off-upload-image` | — |
| GET | `/api/v1/proofs` | — |
| GET | `/api/v1/proofs/{id}` | — |
| PATCH | `/api/v1/proofs/{id}` | — |
| DELETE | `/api/v1/proofs/{id}` | — |
| POST | `/api/v1/proofs/{id}/flag` | — |
| GET | `/api/v1/proofs/{id}/history` | — |
| GET | `/api/v1/proofs/drafts` | — |
| GET | `/api/v1/proofs/drafts/{id}` | — |
| PATCH | `/api/v1/proofs/drafts/{id}` | — |
| DELETE | `/api/v1/proofs/drafts/{id}` | — |
| POST | `/api/v1/proofs/drafts/{id}/anonymize` | — |
| POST | `/api/v1/proofs/drafts/upload` | — |
| POST | `/api/v1/proofs/process-with-gemini` | — |
| POST | `/api/v1/proofs/upload` | — |
| GET | `/api/v1/receipt-items` | — |
| POST | `/api/v1/receipt-items` | — |
| GET | `/api/v1/receipt-items/{id}` | — |
| PATCH | `/api/v1/receipt-items/{id}` | — |
| DELETE | `/api/v1/receipt-items/{id}` | — |
| GET | `/api/v1/session` | — |
| DELETE | `/api/v1/session` | — |
| GET | `/api/v1/stats` | — |
| GET | `/api/v1/status` | — |
| GET | `/api/v1/users` | — |
| GET | `/api/v1/users/{user_id}` | — |

…and 1 more operations. They are listed in full on the page.

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/openapi/open-food-facts-open-prices-openapi.yml
- **OpenAPI** — https://prices.openfoodfacts.org/api/schema
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/overlays/open-food-facts-open-prices-overlay.yaml
- **Documentation** — https://prices.openfoodfacts.org/api/docs

## Other Open Food Facts APIs (11)

- [Open Food Facts API v2](https://apis.io/apis/open-food-facts/open-food-facts-api-v2/)
- [Open Food Facts API v3](https://apis.io/apis/open-food-facts/open-food-facts-api-v3/)
- [Search-a-licious API](https://apis.io/apis/open-food-facts/open-food-facts-search-a-licious/)
- [Folksonomy Engine API](https://apis.io/apis/open-food-facts/open-food-facts-folksonomy/)
- [Facets Knowledge Panels API](https://apis.io/apis/open-food-facts/open-food-facts-facets-knowledge-panels/)
- [NutriPatrol API](https://apis.io/apis/open-food-facts/open-food-facts-nutripatrol/)
- [Open Food Facts Cgi API](https://apis.io/apis/open-food-facts/open-food-facts-cgi-api/)
- [Open Food Facts Product API](https://apis.io/apis/open-food-facts/open-food-facts-product-api/)
- [Open Food Facts Search API](https://apis.io/apis/open-food-facts/open-food-facts-search-api/)
- [Open Food Facts Taxonomy API](https://apis.io/apis/open-food-facts/open-food-facts-taxonomy-api/)
- [Open Food Facts Taxonomy Suggestions API](https://apis.io/apis/open-food-facts/open-food-facts-taxonomy-suggestions-api/)

## Tags

Prices, Retail

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/open-food-facts/open-food-facts-open-prices/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/open-food-facts/.
