---
title: "Pension coverage of modelled monthly essentials, ranked by country"
method: GET
path: "/api/retire-on.json"
---

# Pension coverage of modelled monthly essentials, ranked by country

`GET /api/retire-on.json`

## Request

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

A fixed monthly pension (default GBP 1,500) divided by each country's modelled essentials, ranked, with healthcare out-of-pocket per month, life expectancy and the retiree-visa kind beside each row. Modelled costs; an ordering, not a budget. For information only; every response says so first.

## Query parameters

- `amount` number
- `currency` string
- `limit` number

## Response `200`

Ranked rows with coverage; attribution names the basket, health spending, the World Bank series and the visa register

## Other responses

- `400`: A non-positive amount (INVALID_PARAM)
- `422`: An unsupported currency (UNKNOWN_CURRENCY)

---

[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)