# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/energymadeeasy/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/energymadeeasy/get-plan-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energymadeeasy/search-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"postcode":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.