# Recovery — 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 for recovery centers across the country, browse available locations, and access detailed information about specific facilities including services, reviews, and contact details on Recovery.com. Find the right treatment center by location or search criteria to compare options and make informed decisions about recovery resources.

**Category:** Healthcare | **Website:** [recovery.com/](https://recovery.com/) | **Docs:** [parse.bot/marketplace/91af3518-d16a-4baf-895e-8ddb36712a1a/recovery-com-api](https://parse.bot/marketplace/91af3518-d16a-4baf-895e-8ddb36712a1a/recovery-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/recovery/`
**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 center detail

Retrieve full details for a specific recovery center by its slug. The slug is obtained from search_centers results. Returns comprehensive information including contact, insurance, amenities, treatment methods, team, reviews, and location data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The unique slug of the recovery center, obtained from search_centers results (e.g. 'ascendant-bali', 'greenhouse-treatment-texas'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/recovery/get-center-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get locations list

List all US states, cities, and regions that have listed recovery centers. Returns location names with center counts, sorted alphabetically. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### Search centers

Search for recovery centers with optional filters for location, condition, and insurance. Returns paginated results (0-indexed pages). Each center summary includes a slug usable with get_center_detail for full information. Filtering by location accepts values from get_locations_list; condition and insurance are forwarded to the upstream index.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `condition` | string | No | Filter by condition treated (e.g. 'Drug Addiction', 'Alcohol', 'Cocaine', 'Opioids'). |
| `insurance` | string | No | Filter by accepted insurance provider (e.g. 'Aetna', 'Cigna', 'BlueCross BlueShield'). |
| `limit` | integer | No | Number of results per page. |
| `location` | string | No | Filter by location as listed in get_locations_list (e.g. 'Texas', 'Austin', 'California'). |
| `page` | integer | No | Page number for pagination (0-indexed). |
| `query` | string | No | Search keyword (center name or general term). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/recovery/search-centers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"condition":"<string>","insurance":"<string>","limit":"<integer>","location":"<string>","page":"<integer>","query":"<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.