Documentation menu

← Parcels

API reference

Search parcels

GET/v1/parcel

Searches parcels by address, parcel number, point or area.

To find a specific parcel, send one of address, apn (with jurisdiction or fips), or lat with lon. Each result carries a match, best match first.

To list parcels in an area, send bbox, or lat, lon and radius, or jurisdiction or fips. Narrow the list with filters. Each range filter has a min_ and a max_ form, and either can be sent alone. sort sets the order.

Parameters

query

addressstring | null
A street address, with city or postal code where known, such as 4516 Printer Ln, Raleigh NC 27613. A state or city in the address limits results to parcels there. Results are the matching parcels, best match first.
apnstring | null
A parcel number, as published. Case and spaces are ignored. Requires jurisdiction or fips.
latnumber | null
Latitude, in WGS 84. Requires lon. Results are the parcels at the point, or around it with radius.
lonnumber | null
Longitude, in WGS 84. Requires lat.
radiusnumber | null
Search radius around lat and lon, in meters. At most 25,000. Results are the parcels whose centroid is within it, nearest first.
bboxstring | null
A bounding box, as west,south,east,north in WGS 84. Results are limited to parcels that intersect it.
jurisdictionstring[] | null
A jurisdiction id. Results are limited to parcels it assesses or that lie within it. Repeatable.
fipsstring[] | null
A Census GEOID: 2 digits for a state or 5 for a county, such as 48 or 48453. Results are limited to parcels within it. Repeatable.
ownerstring | null
An owner name, or words from it. Results are parcels with an owner name containing every word, best match first.
localitystring | null
City, town or village of the parcel's address. Case and accents are ignored. Parcels without an address never match.
postal_codestring | null
ZIP or postal code of the parcel's address. Parcels without an address never match.
usestring[] | null
Land use code, as published by the assessor. Repeatable.
classstring[] | null
Property class code, as published by the assessor. Repeatable.
land_useenum[] | null
Standard land use, such as vacant or residential.single_family. A category also matches each of its kinds. Matches the parcel's land use or property class. Repeatable.
Show possible values
residential
Residential. LBCS activity 1000.
residential.single_family
Single family. LBCS activity 1100.
residential.multi_family
Multifamily, two or more units in one building. LBCS activity 1100.
residential.condominium
Condominium unit. LBCS activity 1100.
residential.mobile_home
Mobile or manufactured home. LBCS activity 1100.
residential.common_area
Common area of a subdivision or condominium. LBCS activity 1000.
commercial
Commercial. LBCS activity 2000.
commercial.retail
Retail. LBCS activity 2100.
commercial.office
Office. LBCS activity 2300.
commercial.lodging
Hotel or motel. LBCS activity 1200.
commercial.recreation
Commercial recreation, such as a golf course or marina. LBCS activity 7000.
commercial.parking
Parking lot or garage. LBCS activity 5210.
industrial
Industrial. LBCS activity 3000.
industrial.manufacturing
Manufacturing. LBCS activity 3110.
industrial.warehouse
Warehouse or distribution. LBCS activity 3120.
industrial.mining
Mining or quarry. LBCS activity 8600.
agricultural
Agricultural. LBCS activity 8000.
agricultural.timber
Timber or forest. LBCS activity 8400.
vacant
Vacant land. LBCS activity 9000.
vacant.residential
Vacant residential land. LBCS activity 9000.
vacant.commercial
Vacant commercial land. LBCS activity 9000.
vacant.industrial
Vacant industrial land. LBCS activity 9000.
institutional
Institutional. LBCS activity 4000.
institutional.government
Government, including public parks. LBCS activity 4000.
institutional.religious
Religious. LBCS activity 6600.
institutional.education
School or college. LBCS activity 4100.
institutional.health
Hospital or care facility. LBCS activity 4500.
institutional.cemetery
Cemetery. LBCS activity 4600.
open_space
Open space. LBCS activity 9000.
open_space.conservation
Conservation land, preserve or easement. LBCS activity 9000.
open_space.water
Water, submerged land or wetland. LBCS activity 9000.
open_space.recreation
Recreation land that is not a business, such as a hunting camp. LBCS activity 7200.
utility
Utility, transportation or right of way. LBCS activity 4300.
mixed
Mixed residential and commercial use. No LBCS activity.
exempt
Exempt from tax, use not stated. No LBCS activity.
mineral_rights
Mineral or subsurface rights, with no surface. LBCS activity 9300.
min_acresnumber | null
Minimum area, in acres. Parcels without a boundary never match.
max_acresnumber | null
Maximum area, in acres. Parcels without a boundary never match.
min_market_valuenumber | null
Minimum total market value, in US dollars. Parcels without a market value never match.
max_market_valuenumber | null
Maximum total market value, in US dollars. Parcels without a market value never match.
min_year_builtinteger | null
Earliest year built. Parcels without a building never match.
max_year_builtinteger | null
Latest year built. Parcels without a building never match.
min_building_areanumber | null
Minimum gross building area, in square feet. Parcels without a building never match.
max_building_areanumber | null
Maximum gross building area, in square feet. Parcels without a building never match.
min_sale_pricenumber | null
Minimum price of the most recent sale, in US dollars. Parcels without a sale never match.
max_sale_pricenumber | null
Maximum price of the most recent sale, in US dollars. Parcels without a sale never match.
min_sale_datestring | null
Earliest date of the most recent sale, as YYYY-MM-DD. Parcels without a sale never match.
max_sale_datestring | null
Latest date of the most recent sale, as YYYY-MM-DD. Parcels without a sale never match.
sortstring | null
Sort order. One of acres, as_of, building_area, market_value, sale_date, sale_price, year_built. Prefix with - for descending. Parcels without a value sort last. Not accepted with address or owner.
includestring | null
Comma-separated sections to include. One of geometry (each boundary, as GeoJSON).
format"json" | "geojson"
Response format. One of json (a list) or geojson (a FeatureCollection). Defaults to json. Accept: application/geo+json also selects geojson.
cursorstring | null
A cursor for pagination: the next_cursor from the previous page.
sizeinteger | null
Number of results per page, between 1 and 200. Defaults to 20.
totalboolean
Whether to include total, the count of all matches, on the first page. Defaults to false.

Responses

200
array of parcel objects
A page of parcels.
401
ProblemDetail
credential_missing, credential_invalid or credential_expired. The request has no valid credential.
402
ProblemDetail
quota_exhausted. The credit balance is too low for this request. Nothing is charged.
403
ProblemDetail
scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
422
ProblemDetail
parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429
ProblemDetail
rate_limited. Too many requests. Retry after the Retry-After interval. Nothing is charged.
501
ProblemDetail
not_available. Parcel data is not available yet.

Credits

1 credit per lookup by address, apn or point. 1 credit per 20 results for an area or a filter. Repeat requests within 24 hours are free.

Example request

curl -G 'https://api.placestack.com/v1/parcel' \
  --data-urlencode 'address=4516 Printer Ln, Raleigh, NC 27613' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "object": "list",
  "data": [
    {
      "object": "parcel",
      "id": "prc_01h455vb4pex5vsknk084sn02q",
      "number": {
        "scheme": "pin",
        "value": "1717353946",
        "normalized": "1717353946"
      },
      "identifiers": [
        {
          "scheme": "pin",
          "value": "1717353946",
          "normalized": "1717353946",
          "primary": true
        }
      ],
      "jurisdiction": {
        "id": "jur_01h455vb4pex5vsknk084sn02q",
        "name": "Wake",
        "type": "county",
        "fips": "37183",
        "href": "/v1/jurisdiction/jur_01h455vb4pex5vsknk084sn02q"
      },
      "within": [
        {
          "id": "jur_01h455vb4pex5vsknk084sn02q",
          "name": "North Carolina",
          "tier": "region",
          "type": "state",
          "fips": "37"
        }
      ],
      "status": "active",
      "type": {
        "code": "RP",
        "description": "Real property"
      },
      "area": {
        "sq_m": 1439.65,
        "acres": 0.356,
        "stated_acres": 0.36
      },
      "centroid": {
        "lat": 35.8492,
        "lon": -78.6996
      },
      "addresses": [
        {
          "raw": "4516 PRINTER LN, RALEIGH NC 27613",
          "recipient": "C/O TRIANGLE PROPERTY MANAGEMENT",
          "street_line_1": "4516 PRINTER LN",
          "street_line_2": "APT 1402",
          "street_number": "4516",
          "street_name": "PRINTER",
          "unit": "B",
          "locality": "RALEIGH",
          "region": "NC",
          "postal_code": "27613",
          "point": {
            "lat": 35.8492,
            "lon": -78.6996
          },
          "role": "site",
          "primary": true
        }
      ],
      "owners": [
        {
          "name": "SMITH, JORDAN",
          "kind": {
            "code": "I",
            "description": "Individual"
          },
          "order": 1,
          "mailing": {
            "raw": "4516 PRINTER LN, RALEIGH NC 27613",
            "recipient": "C/O TRIANGLE PROPERTY MANAGEMENT",
            "street_line_1": "4516 PRINTER LN",
            "street_line_2": "APT 1402",
            "street_number": "4516",
            "street_name": "PRINTER",
            "unit": "B",
            "locality": "RALEIGH",
            "region": "NC",
            "postal_code": "27613",
            "point": {
              "lat": 35.8492,
              "lon": -78.6996
            }
          }
        }
      ],
      "assessment": {
        "tax_year": 2026,
        "class": {
          "code": "R",
          "description": "Residential",
          "standard": "residential"
        },
        "use": {
          "code": "SINGLFAM",
          "description": "Single family",
          "standard": "residential.single_family"
        },
        "value": {
          "market": {
            "land": 120000,
            "improvement": 526875,
            "total": 646875
          },
          "assessed": {
            "total": 646875
          },
          "taxable": {
            "total": 646875
          }
        },
        "exemptions": [
          {
            "type": "homestead",
            "code": "SR",
            "description": "Elderly or disabled exclusion",
            "standard": "homestead",
            "amount": 25000,
            "percentage": 0.5
          }
        ]
      },
      "buildings": [
        {
          "building_number": "1",
          "type": "Single Family",
          "description": "CUSTOM HOME",
          "use_code": "RES",
          "value": 520866,
          "year_built": 2007,
          "effective_year_built": 2015,
          "building_area_sq_ft": 3120,
          "living_area_sq_ft": 2629,
          "stories": 2,
          "unit_count": 1,
          "bedroom_count": 4,
          "full_bath_count": 2,
          "half_bath_count": 1,
          "construction_type": "Frame",
          "quality_code": "10",
          "quality_description": "B+",
          "condition_code": "AV",
          "condition_description": "Average",
          "garage_type": "Attached garage",
          "basement_type": "Finished",
          "fireplace": true,
          "percent_complete": 100,
          "heating_type": "Forced air",
          "style": "Ranch",
          "room_count": 7,
          "bath_count": 2.5,
          "exterior_wall": "Vinyl siding",
          "roof_cover": "Asphalt shingle",
          "roof_type": "Gable",
          "foundation_type": "Crawl space",
          "cooling_type": "Central air",
          "heating_fuel": "Gas",
          "fireplace_count": 1,
          "garage_area_sq_ft": 440,
          "basement_area_sq_ft": 960,
          "basement_finished_area_sq_ft": 500,
          "year_remodeled": 2006
        }
      ],
      "sales": [
        {
          "date": "2021-06-14",
          "month": "2021-06",
          "recording_date": "2021-06-21",
          "price": 485000,
          "document_number": "2021045871",
          "deed_type": {
            "code": "WD",
            "description": "Warranty deed"
          },
          "book": "018512",
          "page": "01177",
          "qualification": {
            "code": "Q",
            "description": "Qualified"
          },
          "grantor": "JOHNSON, TAYLOR",
          "grantee": "RIVERA, SAM",
          "transfer_tax": 970,
          "vacant_land": false,
          "new_construction": false,
          "deed_reference": "4E-417",
          "document_url": "http://regdeeds.pittcountync.gov/External/LandRecords/protected/v4/SrchBookPage.aspx?bAutoSearch=true&bk=4E&pg=417"
        }
      ],
      "legal": {
        "description": "LO12 PRINTER RIDGE PH2 BM2004-01234",
        "subdivision": "PRINTER RIDGE",
        "plat_name": "PRINTER RIDGE PH 2",
        "plat_book": "2004",
        "plat_page": "1234",
        "block": "A",
        "lot": "12",
        "section": "14",
        "township": "12N",
        "range": "3E"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -78.6999,
              35.849
            ],
            [
              -78.6993,
              35.849
            ],
            [
              -78.6993,
              35.8494
            ],
            [
              -78.6999,
              35.8494
            ],
            [
              -78.6999,
              35.849
            ]
          ]
        ]
      },
      "match": {
        "method": "address",
        "score": 1,
        "matched": "4516 PRINTER LN, RALEIGH NC 27613"
      },
      "as_of": "2026-10-01",
      "href": "/v1/parcel/prc_01h455vb4pex5vsknk084sn02q"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJrIjoiMjAyNi0xMC0wMSIsInQiOjQyfQ",
  "suppressed": 0,
  "total": {
    "value": 1,
    "relation": "eq"
  }
}

Next steps

POST /parcel/batch

Resolve a batch of parcels

Continue