# Caring — 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 and compare elder care facilities on Caring.com to find detailed information about assisted living, memory care, nursing homes, and more. Access comprehensive facility listings with ratings, pricing, amenities, and resident reviews to help evaluate senior care options across the US.

**Category:** Healthcare | **Website:** [caring.com/](https://caring.com/) | **Docs:** [parse.bot/marketplace/a2fb3442-1465-4029-983b-7b5eb865b972/caring-com-api](https://parse.bot/marketplace/a2fb3442-1465-4029-983b-7b5eb865b972/caring-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/caring/`
**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 facility detail

Get detailed information for a specific facility including address, description, amenities, reviews, pricing, and capacity. The slug is the full path returned by search_facilities (e.g. /senior-living/california/los-angeles/facility-name-90001). Returns a single facility object with all available profile data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Facility slug path starting with /senior-living/ (e.g. /senior-living/california/los-angeles/example-facility-90001). Obtainable from search_facilities results[*].slug. |

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

### Get facility reviews

Get user reviews for a specific facility. Returns the facility name and all available reviews. Each review includes author name, date, numeric rating, text content, and the reviewer's relationship type. Uses the same slug format as get_facility_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Facility slug path starting with /senior-living/ (e.g. /senior-living/california/los-angeles/example-facility-90001). Obtainable from search_facilities results[*].slug. |

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

### Search facilities

Search for elder care facilities by location and care type. Returns a list of facility summaries with names, addresses, ratings, and slugs for detail lookups. Results are scoped to one city within one state. The total count reflects all matching facilities for the location/type combination, not just the returned page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City name as a URL slug (lowercase, hyphens for spaces). |
| `state` | string | No | State name as a URL slug (lowercase, hyphens for spaces). |
| `type` | string | No | Care type slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/caring/search-facilities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","state":"<string>","type":"<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.