# IAEA PRIS — 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.

> Look up comprehensive nuclear power reactor information worldwide, including operational status, specifications, construction progress, and country-by-country statistics from the International Atomic Energy Agency's official database. Monitor active reactors, planned projects, and decommissioned facilities across different nations to track global nuclear energy capacity and development.

**Category:** Government & Public Data | **Website:** [pris.iaea.org/](https://pris.iaea.org/) | **Docs:** [parse.bot/marketplace/8e624db9-643c-4e7b-9cef-f84527cf300b/pris-iaea-org-api](https://parse.bot/marketplace/8e624db9-643c-4e7b-9cef-f84527cf300b/pris-iaea-org-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-pris-iaea-org-api-8e624db9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### country_details

Returns detailed information for a specific country's nuclear program including all reactors (with name, type, status, location, capacities, and grid connection date), a summary of reactor counts by status, nuclear electricity share trend data, and total reactor count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | Yes | ISO 2-letter country code. Use list_countries endpoint to get all valid codes. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pris-iaea-org-api-8e624db9/country_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>"}'
```

### list_countries

Returns all countries that have or have had nuclear reactor programs, each with its ISO 2-letter code and full name. Use the returned country_code values as input to the country_details endpoint.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pris-iaea-org-api-8e624db9/list_countries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### operational_reactors_by_country

Returns a global summary of operational and suspended-operation reactors grouped by country. Each country entry includes the number of reactors and total net electrical capacity in MW. Global totals are provided for both categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pris-iaea-org-api-8e624db9/operational_reactors_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### reactor_details

Returns comprehensive details for a specific reactor including type, model, owner, operator, capacities, key milestone dates, lifetime performance metrics, full annual operating history, and sibling reactors at the same site/country. Reactor IDs can be discovered from sibling_reactors in any reactor_details response or from the country_details endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `reactor_id` | string | Yes | Numeric reactor ID as a string (e.g. '3' for ATUCHA-1, '85' for BIBLIS-A). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pris-iaea-org-api-8e624db9/reactor_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reactor_id":"<string>"}'
```

### shutdown_reactors_by_country

Returns a global summary of permanently shutdown reactors grouped by country. Each country entry includes the number of reactors and total net electrical capacity in MW, with global totals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pris-iaea-org-api-8e624db9/shutdown_reactors_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### under_construction_by_country

Returns a global summary of reactors currently under construction grouped by country. Each country entry includes the number of reactors and total net electrical capacity in MW, with global totals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pris-iaea-org-api-8e624db9/under_construction_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```