# Energymadeeasy — 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.

> Search Australian energy plans by location and get detailed pricing, terms, and provider information. Compare plan features and availability across different areas to make informed decisions about energy providers.

**Category:** Government & Public Data | **Website:** [www.energymadeeasy.gov.au/](https://www.energymadeeasy.gov.au/) | **Docs:** [parse.bot/marketplace/4587feeb-d00e-47da-b424-9eece3bd77b9/energymadeeasy-gov-au-api](https://parse.bot/marketplace/4587feeb-d00e-47da-b424-9eece3bd77b9/energymadeeasy-gov-au-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-energymadeeasy-gov-au-api-4587feeb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_plan_details

Retrieve a single energy plan by its plan ID. Returns plan metadata (name, retailer, fuel type, distributor, status, effective date) and checks whether the plan is available in the given postcode. The postcode param controls availability lookup only — the plan data itself is returned regardless.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `plan_id` | string | Yes | The energy plan identifier (alphanumeric code such as RED552165MRE) |
| `postcode` | string | No | Australian 4-digit postcode to check plan availability against |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energymadeeasy-gov-au-api-4587feeb/get_plan_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan_id":"<string>","postcode":"<string>"}'
```

### search_locations

Search for delivery area locations by Australian postcode. Returns all suburbs and localities within the specified postcode with their geographic coordinates (latitude/longitude), state, and internal location ID. A single postcode typically maps to multiple suburbs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `postcode` | string | Yes | Australian 4-digit postcode to search (e.g. 2000, 4000, 5000) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energymadeeasy-gov-au-api-4587feeb/search_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"postcode":"<string>"}'
```