# Epi Yale — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Retrieve environmental performance scores and rankings for any of 177 countries using Yale's 2026 Environmental Performance Index, including overall ratings, individual indicator scores, and country details. Compare how nations perform across environmental sustainability metrics to track progress and identify leaders in ecological performance.

**Category:** Government & Public Data | **Website:** [epi.yale.edu/indicator/2026/EPI](https://epi.yale.edu/indicator/2026/EPI) | **Docs:** [parse.bot/marketplace/8deb2faa-6419-4582-a37b-e77112063b9b/epi-yale-edu-api](https://parse.bot/marketplace/8deb2faa-6419-4582-a37b-e77112063b9b/epi-yale-edu-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-epi-yale-edu-api-8deb2faa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_country_epi

Returns the full Environmental Performance Index scorecard for a given country, including 47 indicator scores, ranks, 10-year changes, regional ranks, and regional averages. Also includes country metadata (GDP, population, land area). Accepts country name (e.g. 'Netherlands') or ISO 3166-1 alpha-3 code (e.g. 'NLD'). Makes two requests: one to resolve the country's region, one to fetch its data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country name (e.g. 'Netherlands', 'Brazil') or ISO 3166-1 alpha-3 code (e.g. 'NLD', 'BRA'). Case-insensitive. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-epi-yale-edu-api-8deb2faa/get_country_epi \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>"}'
```
