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

> Access data from taylormorrison.com.

**Category:** Real Estate | **Website:** [www.taylormorrison.com/ca/southern-california/irvine/lily-at-great-park-neighborhoods](https://www.taylormorrison.com/ca/southern-california/irvine/lily-at-great-park-neighborhoods) | **Docs:** [parse.bot/marketplace/fe609152-f4f3-4373-8d88-cb710c187daa/taylormorrison-com-api](https://parse.bot/marketplace/fe609152-f4f3-4373-8d88-cb710c187daa/taylormorrison-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-taylormorrison-com-api-fe609152/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_community_plans

Get detailed floor plan information for a specific Taylor Morrison community. Returns each floor plan with its name, starting price, bedroom/bathroom counts, square footage, and direct URL. The community_path can be obtained from the listing_url field in search_communities results (the path portion after the domain).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `community_path` | string | Yes | URL path to the community page, e.g. /ca/southern-california/irvine/aurora-at-luna-park. Obtainable from search_communities results listing_url field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-taylormorrison-com-api-fe609152/get_community_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"community_path":"<string>"}'
```

### search_available_homes

Search available quick move-in (QMI) homes by state. Returns individual homes that are built or under construction and available for purchase, with specific pricing, floor plan name, address, square footage, and bedroom/bathroom counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Two-letter US state abbreviation. Accepted values: AZ, CA, CO, FL, GA, NV, NC, TX, WA. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-taylormorrison-com-api-fe609152/search_available_homes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### search_communities

Search Taylor Morrison new home communities by state. Returns all communities in the given state with summary information including pricing ranges, bedroom/bathroom counts, square footage, and community status. Includes both active and sold-out communities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Two-letter US state abbreviation. Accepted values: AZ, CA, CO, FL, GA, NV, NC, TX, WA. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-taylormorrison-com-api-fe609152/search_communities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```