List external knowledge panel sources (JSON)

Returns the ordered list of external knowledge panel sources configured on the server.

Providers can use the knowledge_panel_url field to point to their own API. The URL may contain template variables that the frontend will expand before calling:

$code → product barcode
$lc → UI language (2 letters)
$cc → user/device country (2 letters)

Example: https://provider.example.com/off/v1/knowledge-panel/$code?lang=$lc&country=$cc

The frontend percent-encodes the variable values when substituting them into the URL.

Authorization

User-Agent<token>

Identification using the User-Agent header. This is recommended in all requests so that we can contact you if there are issues. If we cannot identify the source of problematic API queries, we may have to block them. User-Agent header in the format 'app_name/app_version (URL or contact info)'

In: header

Response Body

curl -X GET "https://world.openfoodfacts.org/api/v3/external_sources"

curl -X GET "https://world.openfoodfacts.org/api/v3/external_sources"

{
  "status": "success_with_errors",
  "result": {
    "id": "product_updated",
    "name": "Product updated",
    "lc_name": "Produit mis à jour"
  },
  "errors": [
    {
      "message": {
        "id": "sugars_higher_than_carbohydrates",
        "name": "Sugars higher than carbohydrates",
        "lc_name": "Sucres plus élevés que les glucides",
        "description": "Sugars (40g) are higher than carbohydrates (35g).",
        "lc_description": "Les sucres (40g) sont plus élévés que les glucdes."
      },
      "field": {
        "id": "nutriment.sugars",
        "value": "40"
      },
      "impact": {
        "id": "nutrients_not_updated",
        "name": "Nutrients not updated",
        "lc_name": "Nutriments non mis à jour",
        "description": "The nutrients were not updated.",
        "lc_description": "Les nutriments n'ont pas été mis à jour."
      }
    }
  ],
  "external_sources": [
    {
      "id": "empreinte_souffrance",
      "name": "Empreinte Souffrance",
      "description": "Indicator of the amount of animal suffering calculated per product.",
      "icon_url": "https://example.org/logo.png",
      "knowledge_panel_url": "https://provider.example.com/off/v1/knowledge-panel/$code?lang=$lc&country=$cc",
      "provider_name": "Empreinte Souffrance",
      "provider_website": "https://empreinte-souffrance.org/",
      "section": "animal_welfare",
      "filters": {
        "categories": [
          "en:chicken-eggs"
        ],
        "countries": [
          "fr",
          "world"
        ],
        "languages": [
          "fr",
          "en"
        ],
        "product_types": [
          "food"
        ]
      },
      "privacy_policy_url": "https://provider.example.com/privacy",
      "scope": "moderators"
    }
  ]
}

List external knowledge panel sources (JSON)

Authorization

Response Body

200