---
title: "Measured cost of a healthy diet (World Bank), per country or ranked, and the grocery model’s error"
method: GET
path: "/api/food-cost.json"
---

# Measured cost of a healthy diet (World Bank), per country or ranked, and the grocery model’s error

`GET /api/food-cost.json`

## Request

- Base URL: `https://geo-parity.com`
- URL: `https://geo-parity.com/api/food-cost.json`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in query parameter `key`

World Bank Food Prices for Nutrition: the cheapest locally available healthy diet, per person per day, in local currency and USD, with the share who cannot afford it and the food-group split. Also how far this site’s modelled grocery prices are from it (modelError, and modelErrorSummary on a ranking). A least-cost diet, not typical spending; display only. Dollar figures are withheld where a local figure does not convert consistently. For information only; every response says so first.

## Query parameters

- `country` string
- `countries` string
- `metric` 'dailyUsd' | 'unaffordablePct'
- `sort` 'lowest' | 'highest'
- `limit` number

## Response `200`

One country, comparison rows, or ranked rows with modelErrorSummary; attribution names the World Bank series and the FX table

## Other responses

- `400`: A bad metric or sort (INVALID_PARAM) or fewer than two countries (TOO_FEW)
- `422`: A country outside the spine (UNKNOWN_COUNTRY) or with no World Bank survey (NO_DATA)

---

[API](https://skmtc.dev/geo-parity/apis/geo-parity-api.md) · [All operations](https://skmtc.dev/geo-parity/apis/geo-parity-api/llms.txt) · [OpenAPI document](https://skmtc.dev/geo-parity/apis/geo-parity-api/revisions/8ddff47a0806?raw)