---
title: "Lookup homes owned by homeowners"
method: POST
path: "/LookupHomesByOwner"
tags: ["Lookup Homes by Owner"]
---

# Lookup homes owned by homeowners

`POST /LookupHomesByOwner`

Submit a batch request to receive an array of homes owned by a homeowner based on their address (MAK).

The following are the possible minimum input requirements:
- `OwnerMAK`
- `FreeForm`

## Headers

- `Accept` 'application/json' | 'application/xml' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Request body

- RequestLookupHomesByOwner
  - `CustomerId` string, required — Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa.
  - `TransmissionReference` string — This is a string value that serves as a unique identifier for this set of records. It is returned as sent.
  - `FreeForm` string — Free form address for the property.
  - `OwnerMAK` string — A proprietary unique key identifier for an address derived from Address Checking.

## Response `200`

Successful response

- ResponseLookupHomesByOwner
  - `Version` string — The current service version number.
  - `TransmissionReference` string — Serves as a unique request identifier.
  - `Results` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Property Result Codes](https://docs.melissa.com/cloud-api/property/result-codes.html).
  - `TotalRecords` integer — Total number of records.
  - `Records` LookupHomesByOwnerRecords[]
    - `APN` string — The Assessor's Parcel Number (APN).
    - `BaseMAK` string — A unique key assigned to the base address of a complex with apartments or suites.
    - `FIPS` string — The six-digit Federal Information Processing Standard (FIPS) code for the county containing the property.
    - `MAK` string — (Melissa Address Key) A unique key assigned to the address record.
    - `PropertyAddress` string — The address of the property.
    - `PropertyCity` string — The city containing the property.
    - `PropertyPlus4` string — The plus 4 of the ZIP Code containing the property.
    - `PropertyState` string — The state containing the property.
    - `PropertyZip` string — The ZIP Code containing the property.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/melissa/apis/property.md) · [All operations](https://skmtc.dev/melissa/apis/property/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/melissa/property/revisions/20335d778b27/schema)
