---
title: "What a pension is worth in another country, now and after N years"
method: GET
path: "/api/pension-abroad.json"
---

# What a pension is worth in another country, now and after N years

`GET /api/pension-abroad.json`

## Request

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

Converts a monthly pension at the site's FX snapshot, re-prices it at the destination through the PPP engine, and projects it flat at the destination's latest annual inflation for `years`. Without `amount`, the origin's typical state pension (OECD net replacement rate on the modelled median wage) is used and `basis` says so.

## Query parameters

- `from` string, required
- `to` string, required
- `amount` number
- `currency` string
- `years` number

## Response `200`

Worth today and after the period in USD and local currency, erosion, caveats, attribution

## Other responses

- `400`: Missing from/to (MISSING_PARAMS), bad years/amount (INVALID_PARAM), same country (SAME_COUNTRY)
- `422`: Unknown country (UNKNOWN_COUNTRY), unknown currency (UNKNOWN_CURRENCY), or no replacement rate/inflation figure (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)