---
title: "Get count or buy a property list"
method: GET
path: "/{action}_{geographicType}"
tags: ["Property List"]
---

# Get count or buy a property list

`GET /{action}_{geographicType}`

There are multiple endpoints you can access for LeadGen: Property. These endpoints are all formatted like:

`https://list.melissadata.net/v2/Property/{action}_{geographicType}`

Make sure to replace `{action}` and `{geographicType}` with the appropriate values. For more information on the available actions and geographic types, see the parameters below.

## Path parameters

- `action` 'count' | 'buy', required
- `geographicType` 'zip' | 'address' | 'street' | 'city' | 'county' | 'state' | 'circle' | 'polygon' | 'rectangle', required

## Query parameters

- `id` string, password, required
- `zip` string, required
- `addr` string
- `ctyst` string
- `city` string
- `cntyst` string
- `state` string
- `mile` string
- `street` string
- `num1` string
- `num2` string
- `pt` string
- `propertype` string
- `bedrooms` string
- `bathrooms` string
- `units` string
- `yearbuilt` string
- `pval` string
- `equity` string
- `lvratio` string
- `sqft` string
- `bsqft` string
- `lot` string
- `samt` string
- `sdt` string
- `pool` integer
- `heat` integer
- `ac` integer
- `fireplace` integer
- `mtgAmt` string
- `mtgAmt1` string
- `mtgAmt2` string
- `mtgRt` string
- `mtgRtTp` string
- `mtgRecDt` string
- `mtgTp` string
- `mtgScb` string
- `occu` string
- `owntrs` string
- `vacant` string
- `hhage` string
- `gender` string
- `hhinc` string
- `marital` string
- `lores` string
- `people` string
- `adults` string
- `kids` string
- `qty` integer
- `file` 1 | 3 | 5 | 6 | 8 | 10
- `emails` 0 | 1 | 2
- `femails` 0 | 1
- `one` boolean
- `xml` boolean

## Headers

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

## Response `200`

Successful Response

- Response
  - `options` object
    - `propertyOptions` string[]
    - `mortgageOptions` string[]
    - `occupantOptions` string[]
    - `demographicOptions` string[]
    - `foreclosureOptions` string[]
    - `listOptions` string[]
  - `areas` object[]
    - `geo` string
    - `count` integer
    - `message` string
  - `summary` object
    - `geoType` string
    - `totalCount` integer
    - `orderId` integer
    - `fileUrl` string
    - `status` object[]
      - `statusCode` integer — For details of all status codes please visit [here](https://docs.melissa.com/other/status-codes-index.html). All Melissa products use result codes. LeadGen - Property Status codes are numeric codes, e.g. `101`. Status codes are returned as a comma-delimited string with no whitespace, e.g. `100,101`.
      - `statusDetail` string

## Other responses

- `400` — Bad Request

---

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