Open Food Facts Moderation API
The moderation API from Open Food Facts — 4 operation(s) for moderation.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/open-food-facts:open-food-facts-moderation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Open Food Facts open-prices REST Moderation API
version: 0.0.0 (api)
description: Open Prices API allows you to add product prices
contact:
name: The Open Food Facts team
url: https://world.openfoodfacts.org
email: contact@openfoodfacts.org
license:
name: ' AGPL-3.0'
url: https://www.gnu.org/licenses/agpl-3.0.en.html
tags:
- name: Moderation
paths:
/api/v1/flags:
get:
operationId: flags_list
parameters:
- in: query
name: content_type
schema:
type: array
items:
type: string
title: Python model class name
enum:
- PRICE
- PROOF
description: '* `PRICE` - Price
* `PROOF` - Proof'
explode: true
style: form
- in: query
name: object_id
schema:
type: integer
- name: order_by
required: false
in: query
description: Which field to use when ordering the results.
schema:
type: string
- name: page
required: false
in: query
description: A page number within the paginated result set.
schema:
type: integer
- in: query
name: reason
schema:
type: array
items:
type: string
enum:
- OTHER
- WRONG_CURRENCY
- WRONG_DATE
- WRONG_LOCATION
- WRONG_PRICE_VALUE
- WRONG_PRODUCT
- WRONG_TYPE
description: '* `WRONG_TYPE` - Wrong type
* `WRONG_PRICE_VALUE` - Wrong price value
* `WRONG_CURRENCY` - Wrong currency
* `WRONG_PRODUCT` - Wrong product
* `WRONG_LOCATION` - Wrong location
* `WRONG_DATE` - Wrong date
* `OTHER` - Other'
explode: true
style: form
- name: size
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: status
schema:
type: string
enum:
- CLOSED
- OPEN
description: '* `OPEN` - Open
* `CLOSED` - Closed'
tags:
- Moderation
security:
- CustomAuthentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedFlagList'
description: ''
summary: Flags list
x-summary-source: derived
/api/v1/flags/{id}:
patch:
operationId: flags_partial_update
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this Flag.
required: true
tags:
- Moderation
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PatchedFlagUpdate'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/PatchedFlagUpdate'
multipart/form-data:
schema:
$ref: '#/components/schemas/PatchedFlagUpdate'
security:
- CustomAuthentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FlagUpdate'
description: ''
summary: Flags partial update
x-summary-source: derived
/api/v1/prices/{id}/flag:
post:
operationId: prices_flag_create
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this Price.
required: true
tags:
- Moderation
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FlagCreate'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/FlagCreate'
multipart/form-data:
schema:
$ref: '#/components/schemas/FlagCreate'
required: true
security:
- CustomAuthentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Flag'
description: ''
summary: Prices flag create
x-summary-source: derived
/api/v1/proofs/{id}/flag:
post:
operationId: proofs_flag_create
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this Proof.
required: true
tags:
- Moderation
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FlagCreate'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/FlagCreate'
multipart/form-data:
schema:
$ref: '#/components/schemas/FlagCreate'
required: true
security:
- CustomAuthentication: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Flag'
description: ''
summary: Proofs flag create
x-summary-source: derived
components:
schemas:
ReasonEnum:
enum:
- WRONG_TYPE
- WRONG_PRICE_VALUE
- WRONG_CURRENCY
- WRONG_PRODUCT
- WRONG_LOCATION
- WRONG_DATE
- OTHER
type: string
description: '* `WRONG_TYPE` - Wrong type
* `WRONG_PRICE_VALUE` - Wrong price value
* `WRONG_CURRENCY` - Wrong currency
* `WRONG_PRODUCT` - Wrong product
* `WRONG_LOCATION` - Wrong location
* `WRONG_DATE` - Wrong date
* `OTHER` - Other'
Flag:
type: object
properties:
id:
type: integer
readOnly: true
content_type:
type: string
readOnly: true
object_id:
type: integer
maximum: 9223372036854775807
minimum: 0
format: int64
reason:
$ref: '#/components/schemas/ReasonEnum'
comment:
type:
- string
- 'null'
status:
$ref: '#/components/schemas/FlagStatusEnum'
owner:
type:
- string
- 'null'
source:
type:
- string
- 'null'
created:
type: string
format: date-time
updated:
type: string
format: date-time
readOnly: true
required:
- content_type
- id
- object_id
- reason
- updated
PaginatedFlagList:
type: object
required:
- items
- page
- pages
- size
- total
properties:
items:
type: array
items:
$ref: '#/components/schemas/Flag'
page:
type: integer
description: Current page number
example: 1
pages:
type: integer
description: Total number of pages
example: 16
size:
type: integer
description: Number of items per page
example: 100
total:
type: integer
description: Total number of items
example: 1531
FlagUpdate:
type: object
properties:
status:
$ref: '#/components/schemas/FlagStatusEnum'
FlagCreate:
type: object
properties:
reason:
$ref: '#/components/schemas/ReasonEnum'
comment:
type:
- string
- 'null'
content_object:
type: string
readOnly: true
required:
- content_object
- reason
FlagStatusEnum:
enum:
- OPEN
- CLOSED
type: string
description: '* `OPEN` - Open
* `CLOSED` - Closed'
PatchedFlagUpdate:
type: object
properties:
status:
$ref: '#/components/schemas/FlagStatusEnum'
securitySchemes:
CustomAuthentication:
type: http
scheme: bearer
x-provenance:
method: harvested
publisher: Open Food Facts
source: https://prices.openfoodfacts.org/api/schema
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)