# Activeadultliving — 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 explore 55+ and active adult communities across the USA and Canada by state, lifestyle amenities, and community details. Find showcase communities and access comprehensive information about senior living options to help you discover the perfect retirement community.

**Category:** Real Estate | **Website:** [activeadultliving.com/](https://activeadultliving.com/) | **Docs:** [parse.bot/marketplace/9d9b62a7-b4e5-4a10-be94-eaef9d900d96/activeadultliving-com-api](https://parse.bot/marketplace/9d9b62a7-b4e5-4a10-be94-eaef9d900d96/activeadultliving-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-activeadultliving-com-api-9d9b62a7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_communities_by_state

Returns a paginated list of communities in a given state or province. Each community includes its name, city, lifestyle category, ZIP code, phone number, and home type. Use offset and limit for pagination. The response contains nested objects for city, state, and lifestyle with full metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `abbreviation` | string | Yes | Two-letter state or province abbreviation (e.g. FL, AZ, ON). All 50 US states and Canadian provinces are accepted. |
| `limit` | integer | No | Number of results per page |
| `offset` | integer | No | Offset for pagination (number of items to skip) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-activeadultliving-com-api-9d9b62a7/get_communities_by_state \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"abbreviation":"<string>","limit":"<integer>","offset":"<integer>"}'
```

### get_community_detail

Returns full details for a single community including street address, pricing, HTML description, amenities, home types, overview stats, and gallery images. All parameters are obtained from get_communities_by_state or get_showcase_communities results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City URL slug from community listing results, in the city.url field (e.g. ocala) |
| `community_slug` | string | Yes | Community URL slug from community listing results, in the community_url field (e.g. shea-homes-at-ocala-preserve) |
| `lifestyle_slug` | string | Yes | Lifestyle URL slug from community listing results, in the lifestyle.url field (e.g. active-lifestyle-communities) |
| `state_abbr` | string | Yes | Two-letter state abbreviation (e.g. FL) |
| `state_name` | string | Yes | Full state name (e.g. Florida) |
| `zip` | string | Yes | ZIP code from community listing results (e.g. 34482) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-activeadultliving-com-api-9d9b62a7/get_community_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>","community_slug":"<string>","lifestyle_slug":"<string>","state_abbr":"<string>","state_name":"<string>","zip":"<string>"}'
```

### get_lifestyles

Returns all lifestyle categories used to classify communities (e.g. 55+ Communities, Golf Course Communities, Waterfront). Each entry includes the category name and its URL slug. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-activeadultliving-com-api-9d9b62a7/get_lifestyles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_showcase_communities

Returns featured/showcase communities for a given state. These are premium listings with additional details including descriptions, images, and pricing information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `abbreviation` | string | Yes | Two-letter state abbreviation (e.g. FL, AZ). All 50 US states are accepted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-activeadultliving-com-api-9d9b62a7/get_showcase_communities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"abbreviation":"<string>"}'
```

### get_states

Returns all US states and Canadian provinces that have active adult communities listed. Each entry includes the state name, two-letter abbreviation, URL slug, and a count of communities in that state. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-activeadultliving-com-api-9d9b62a7/get_states \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```