# Riteaid — 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 closed Rite Aid pharmacy locations by ZIP code, find where prescriptions were transferred, and retrieve replacement pharmacy details. Also check the current status of the Rite Aid prescription transfer site.

**Category:** Healthcare | **Website:** [riteaid.com/](https://riteaid.com/) | **Docs:** [parse.bot/marketplace/7aca1485-1ff2-4b52-8036-f334595d11a7/riteaid-com-api](https://parse.bot/marketplace/7aca1485-1ff2-4b52-8036-f334595d11a7/riteaid-com-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/riteaid/`
**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 new pharmacy for store

Get the replacement pharmacy details for a specific Rite Aid store number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_number` | string | Yes | The Rite Aid store number (e.g. 1234). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/riteaid/get-new-pharmacy-for-store \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"store_number":"<string>"}'
```

### Get pharmacy closure by zip

Search for closed Rite Aid pharmacy locations by ZIP code and find where prescriptions were transferred. Returns matching results for the exact ZIP, or nearby results if no exact match is found. Each result shows the old Rite Aid address and the new pharmacy where prescriptions were transferred.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US ZIP code to search for closed Rite Aid locations (e.g. 15232, 10001, 90210). |

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

### Get pharmacy closure list

Get the full list of closed Rite Aid pharmacies and their prescription transfer locations.

**Estimated cost:** Metered

_No parameters required._

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

### Get site status

Get the current status of the Rite Aid prescription transfer page, including the main closure message, page sections, and navigation links.

**Estimated cost:** Metered

_No parameters required._

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

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