---
title: "State pension system profile: one country, side by side, or ranked"
method: GET
path: "/api/pension-systems.json"
---

# State pension system profile: one country, side by side, or ranked

`GET /api/pension-systems.json`

## Request

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

OECD Pensions at a Glance retirement ages (current and future, by sex), replacement rates at 50/100/200% of the average wage, years after exit, old-age poverty, pensioner tax rate; World Bank life expectancy and 65+ share; WBL statutory ages for the countries OECD does not cover. Projection rows excluded. For information only; every response says so first.

## Query parameters

- `country` string
- `countries` string
- `metric` 'retirementAgeMen' | 'retirementAgeWomen' | 'futureRetirementAgeMen' | 'netReplacement100' | 'grossReplacement100' | 'yearsAfterExit' | 'oldAgePoverty' | 'lifeExpectancy' | 'over65Pct'
- `sort` 'highest' | 'lowest'
- `limit` number

## Response `200`

A profile, comparison rows, or a ranking; attribution names OECD PAG, the World Bank series and WBL

## Other responses

- `400`: Fewer than two countries in `countries` (TOO_FEW) or an unknown metric (INVALID_METRIC)
- `422`: A country outside the spine (UNKNOWN_COUNTRY) or with no data (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)