taylor-morrison-home

opencollection: 1.0.0
info:
  name: Taylor Morrison Home Search API
  version: '1.0'
request:
  auth:
    type: apikey
    key: X-API-Key
    value: '{{X-API-Key}}'
    placement: header
items:
- info:
    name: Communities
    type: folder
  items:
  - info:
      name: List Communities
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/communities
      params:
      - name: state
        value: ''
        type: query
        description: Two-letter state code filter
      - name: city
        value: ''
        type: query
        description: City name filter
      - name: metro
        value: ''
        type: query
        description: Metropolitan area name
      - name: price_min
        value: ''
        type: query
        description: Minimum home price
      - name: price_max
        value: ''
        type: query
        description: Maximum home price
      - name: bedrooms
        value: ''
        type: query
        description: Minimum number of bedrooms
      - name: limit
        value: ''
        type: query
        description: Maximum communities to return
      - name: offset
        value: ''
        type: query
        description: Pagination offset
    docs: Returns a list of active Taylor Morrison communities filtered by state, city, metro area, or price range.
  - info:
      name: Get Community
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/communities/:community_id
      params:
      - name: community_id
        value: ''
        type: path
        description: Community identifier
    docs: Returns detailed information about a specific Taylor Morrison community.
- info:
    name: Homes
    type: folder
  items:
  - info:
      name: List Available Homes
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/homes
      params:
      - name: community_id
        value: ''
        type: query
        description: Filter by community
      - name: status
        value: ''
        type: query
        description: Home availability status
      - name: bedrooms
        value: ''
        type: query
        description: Number of bedrooms
      - name: bathrooms
        value: ''
        type: query
        description: Number of bathrooms
      - name: price_min
        value: ''
        type: query
        description: Minimum price
      - name: price_max
        value: ''
        type: query
        description: Maximum price
      - name: sqft_min
        value: ''
        type: query
        description: Minimum square footage
      - name: limit
        value: ''
        type: query
        description: Maximum homes to return
      - name: offset
        value: ''
        type: query
        description: Pagination offset
    docs: Returns available homes (move-in ready and to-be-built) across communities.
  - info:
      name: Get Home Details
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/homes/:home_id
      params:
      - name: home_id
        value: ''
        type: path
        description: Home identifier
    docs: Returns full details of a specific home including floor plan, lot, pricing, and availability.
- info:
    name: Floor Plans
    type: folder
  items:
  - info:
      name: List Floor Plans
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/floor-plans
      params:
      - name: community_id
        value: ''
        type: query
        description: Filter by community
      - name: bedrooms
        value: ''
        type: query
        description: Number of bedrooms
      - name: bathrooms
        value: ''
        type: query
        description: Number of bathrooms
      - name: sqft_min
        value: ''
        type: query
        description: Minimum square footage
      - name: sqft_max
        value: ''
        type: query
        description: Maximum square footage
      - name: stories
        value: ''
        type: query
        description: Number of stories
      - name: limit
        value: ''
        type: query
        description: Maximum floor plans to return
    docs: Returns available floor plans for a community or across all communities.
  - info:
      name: Get Floor Plan
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/floor-plans/:plan_id
      params:
      - name: plan_id
        value: ''
        type: path
        description: Floor plan identifier
    docs: Returns detailed floor plan information including dimensions, rooms, and structural options.
- info:
    name: Lots
    type: folder
  items:
  - info:
      name: List Available Lots
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/lots
      params:
      - name: community_id
        value: ''
        type: query
        description: Community to list lots for
      - name: status
        value: ''
        type: query
        description: Lot availability status
    docs: Returns available lots in a community for to-be-built home construction.
- info:
    name: Reservations
    type: folder
  items:
  - info:
      name: List Reservations
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/reservations
    docs: Returns reservations for the authenticated user.
  - info:
      name: Create Reservation
      type: http
    http:
      method: POST
      url: https://www.taylormorrison.com/api/reservations
      body:
        type: json
        data: '{}'
    docs: Submit an online home reservation for a to-be-built or available home with initial design selections and a deposit.
      This powers Taylor Morrison's industry-first fully digital homebuying flow.
  - info:
      name: Get Reservation
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/reservations/:reservation_id
      params:
      - name: reservation_id
        value: ''
        type: path
        description: Reservation identifier
    docs: Returns details of a specific reservation including status and selections.
- info:
    name: Design
    type: folder
  items:
  - info:
      name: List Design Options
      type: http
    http:
      method: GET
      url: https://www.taylormorrison.com/api/design/options
      params:
      - name: plan_id
        value: ''
        type: query
        description: Floor plan to get options for
      - name: category
        value: ''
        type: query
        description: Option category filter
    docs: Returns available design selections for a floor plan including structural, exterior, and interior options.
bundled: true