Endpoints

Food Detail

Returns the full available nutrient profile for a single food. Intended for detail views, comparison tools, and apps that need data beyond the core macros: up to 150+ nutrients where available, plus all serving size variants.

GET/v1/foods/{id}1 credit / request

Example request

curl

curl https://api.forkbit.io/v1/foods/3f2a1b9c-2e1a-4b8b-9e0a-6b7c8d9e0f1a \
    -H "X-API-Key: fkb_live_xxxxxxxxxxxx"

Example response

200 OK

{
    "id": "3f2a1b9c-2e1a-4b8b-9e0a-6b7c8d9e0f1a",
    "name": "Chicken breast, grilled",
    "canonicalName": "Chicken, broilers or fryers, breast, meat only, cooked, grilled",
    "processingTier": "whole",
    "category": { "slug": "poultry", "name": "Poultry" },
    "dataset": "usda_foundation",
    "providerId": "171077",
    "nutrientCompleteness": "full",
    "energyKcal": 165,
    "proteinG": 31.0,
    "fatG": 3.6,
    "carbsG": 0,
    "fiberG": 0,
    "sugarG": 0,
    "sodiumMg": 74,
    "scientificName": null,
    "publishedAt": "2026-04-01",
    "updatedAt": "2026-04-12",
    "nutrients": [
      { "id": "5c6d7e8f-...", "code": "208", "name": "Energy", "unit": "KCAL", "amount": 165, "sourceNutrientCode": "208" },
      { "id": "5c6d7e90-...", "code": "203", "name": "Protein", "unit": "G", "amount": 31.0, "sourceNutrientCode": "203" }
    ],
    "portions": [
      { "id": "8a9b0c1d-...", "name": "100 g", "gramWeight": 100, "isDefault": true },
      { "id": "8a9b0c1e-...", "name": "1 medium breast", "gramWeight": 174, "isDefault": false }
    ]
  }

Errors

Status	Code	Cause
404	NOT_FOUND	`id` is a well-formed UUID with no matching food.
422	VALIDATION_ERROR	`id`isn't a valid UUID at all.

See Error handling for the common error codes every endpoint can return.