Foods & packaged foods

Search, look up, compare, substitute and submit foods and branded products.

Routes in this category

• GET /foods - List foods
• POST /foods - Create a food (admin)
• GET /foods/{id} - Get a food by id
• PUT /foods/{id} - Replace a food (admin)
• PATCH /foods/{id} - Partially update a food (admin)
• DELETE /foods/{id} - Delete a food (admin)
• GET /foods/{id}/convert - Household and standard measures for the food with this id (API key, rate-limited)
• GET /foods/{id}/label - Codex-oriented nutrition label for one food
• GET /foods/autocomplete - Search-as-you-type suggestions (API key, rate-limited)
• GET /foods/baby-foods - Baby and infant foods (API key, rate-limited)
• POST /foods/bulk - Bulk-create foods (admin)
• GET /foods/by-category - Browse foods by category (API key, rate-limited)
• GET /foods/categories - Food category list (API key, rate-limited, cached 24h)
• GET /foods/compare - Side-by-side nutrient comparison of 2-6 foods (API key, rate-limited)
• GET /foods/convert - Household and standard measures for one food, either way round (API key, rate-limited)
• GET /foods/local-categories - Categories used by the local food table (API key, rate-limited)
• GET /foods/lookup - External food lookup cascade (API key, rate-limited)
• GET /foods/search - Typo-tolerant fuzzy search over foods (API key, rate-limited)
• GET /foods/substitutes - Nutritionally close substitutes for a food (API key, rate-limited)
• GET /measures - Every unit, the printed reference tables and the scoop sizes (API key, rate-limited)
• GET /measures/convert - Unit to unit, no food (API key, rate-limited)
• GET /packaged - List packaged/branded foods
• PUT /packaged/{id} - Replace a packaged food (admin)
• PATCH /packaged/{id} - Partially update a packaged food (admin)
• DELETE /packaged/{id} - Delete a packaged food (admin)
• POST /packaged/{id}/approve - Approve a pending packaged food (admin)
• POST /packaged/{id}/reject - Reject a pending packaged food (admin)
• GET /packaged/pending - Admin review queue (admin)
• POST /packaged/scan - Submit a packaged food via photo (API key, rate-limited)
• POST /packaged/submit - Submit a packaged food (API key, rate-limited)

More in API Reference

• Foods & packaged foods - Search, look up, compare, substitute and submit foods and branded products.
• Meals, intake & food log - Analyze meals and recipes, assess intake against dietary reference intakes, and keep a food diary.
• WHO growth standards - Z-scores, percentiles and status bands from birth to 19 years, and the combined assessment.
• Growth velocity & preterm - WHO increment bands for infants and Fenton preterm growth charts.
• Diets, exchange & formulas - Glycaemic index, food exchange lists, renal nutrition and enteral formulas.
• Energy & drug interactions - Energy requirements and known drug-nutrient interactions.
• Condition-specific nutrition - Calculators for diabetes and carbohydrate counting, kidney disease, pregnancy and lactation, children, sports and weight management.
• Clinical nutrition support - Critical care, burn, refeeding, enteral feeding and energy stress factor calculators.
• Research & epidemiology - Harmonise study data, analyse outcomes and surveys, audit data quality and export analysis-ready datasets.
• FHIR R4 - Stateless growth evaluation and the Nutrition Care Process as FHIR resources.
• AI, knowledge & memory - Retrieval-augmented answers and session memory for assistants.
• Keys & platform - API keys, developer keys, batching, health and metadata.
• More routes - Other documented routes.