# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-recovery-com-api-91af3518/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-recovery-com-api-91af3518/get_center_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-recovery-com-api-91af3518/get_locations_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-recovery-com-api-91af3518/search_centers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"condition":"<string>","insurance":"<string>","limit":"<integer>","location":"<string>","page":"<integer>","query":"<string>"}'
```