# Pacific Power — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Track real-time power outages and service disruptions across Pacific Power's service areas by searching by ZIP code, county, or viewing incident summaries. Monitor current service status and explore detailed outage information to stay informed about utility disruptions across the region.

**Category:** Government & Public Data | **Website:** [pacificpower.net/](https://pacificpower.net/) | **Docs:** [parse.bot/marketplace/fc17eb7c-cbf7-4962-b46e-bb4309965b72/pacificpower-net-api](https://parse.bot/marketplace/fc17eb7c-cbf7-4962-b46e-bb4309965b72/pacificpower-net-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/pacific-power/`
**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 outage by county

Outage status for a single county within a state. Returns counts of planned and unplanned outages and affected customers. Returns zero counts when the county has no active outages (not an error).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `county` | string | Yes | County name (e.g. Douglas, Hood River). Case-insensitive match. |
| `state` | string | No | State code. Accepted values: OR, WA, CA. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pacific-power/get-outage-by-county \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"county":"<string>","state":"<string>"}'
```

### Get outage by zip

Outage status for a single ZIP code within a state. Returns counts of planned and unplanned outages and affected customers. Returns zero counts when the ZIP has no active outages (not an error).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | State code. Accepted values: OR, WA, CA. |
| `zip_code` | string | Yes | 5-digit US ZIP code (e.g. 97211). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pacific-power/get-outage-by-zip \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>","zip_code":"<string>"}'
```

### Get outage incidents

Detailed incident list for a state. Each incident includes geographic coordinates, cause, estimated time of restoration (ETR), crew status, and affected ZIP code. Use for mapping outages or drilling into individual events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | State code. Accepted values: OR, WA, CA. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pacific-power/get-outage-incidents \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### Get outage summary

High-level summary of outages for a given state. Returns total outage counts, total customers affected, and per-county/per-ZIP breakdowns of planned and unplanned outages. Data refreshes every few minutes; the last_updated timestamp indicates freshness.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | State code. Accepted values: OR, WA, CA. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pacific-power/get-outage-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### Get service areas

Static list of states and service areas covered by Pacific Power. Returns the three state codes (OR, WA, CA) and a brief description of coverage.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pacific-power/get-service-areas \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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