# Ameren — 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 hourly electricity prices, current outage summaries, rate information, and energy efficiency programs from Ameren. Covers Illinois and Missouri service areas with real-time and forecast pricing data.

**Category:** Government & Public Data | **Website:** [ameren.com/](https://ameren.com/) | **Docs:** [parse.bot/marketplace/f386995a-ef32-4f92-aef1-4d12b359e1ea/ameren-com-api](https://parse.bot/marketplace/f386995a-ef32-4f92-aef1-4d12b359e1ea/ameren-com-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-ameren-com-api-f386995a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_efficiency_programs

Get links and information for energy efficiency rebate programs available to Ameren customers. Programs include rebates for appliances, insulation, HVAC, and lighting.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Service state. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_efficiency_programs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### get_hourly_prices

Get hourly electricity prices for a specific date. If no date is provided, defaults to the current day. Prices are in $/kWh. Historical dates going back several months are supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Target date in YYYY-MM-DD format. Omitting returns today's prices. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_hourly_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### get_hourly_prices_previous_day

Get the prior day's hourly electricity prices. Returns the full 24-hour price table for yesterday in $/kWh.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_hourly_prices_previous_day \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hourly_prices_today

Get today's 24-hour wholesale electricity price table for Illinois. Returns hourly price data for each hour of the current day. Prices are in $/kWh.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_hourly_prices_today \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hourly_prices_tomorrow

Get tomorrow's hourly electricity prices. Prices are typically available after approximately 5:30 PM CT. Returns null for prices if not yet available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_hourly_prices_tomorrow \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_outage_summary

Get current outage summary data for Illinois and Missouri service areas. Returns the number of active outages, affected customers, and network availability percentage for each region. Data refreshes every few minutes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_outage_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_rates_info

Get links and basic information about residential or business rates for Illinois or Missouri service areas. Returns a URL to the rates page along with a description of available content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Rate category. |
| `state` | string | No | Service state. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ameren-com-api-f386995a/get_rates_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","state":"<string>"}'
```