Retrieve a parcel · API reference

A parcel, with identifiers, addresses, owners, latest assessment, building, sale and legal description.

A parcel's id stays the same when its number or boundary changes. One credit. Repeat requests within a day are free.

Parameters

path

parcel_idrequiredstring: Unique identifier for the parcel.

query

includestring | null: Comma-separated sections to include. One of geometry (the boundary, as GeoJSON).
format"json" | "geojson": Response format. One of json (the object) or geojson (a Feature). Defaults to json. Accept: application/geo+json also selects geojson.

Responses

200: parcel object; The parcel.
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.
404: ProblemDetail; no_such_resource. No parcel has this id.
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.

Example request

curl -X GET 'https://api.placestack.com/v1/parcel/prc_01h455vb4pex5vsknk084sn02q' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "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": [
    {
      "formatted": "4516 PRINTER LN, RALEIGH NC 27613",
      "number": "4516",
      "street": "PRINTER",
      "unit": "B",
      "city": "RALEIGH",
      "state": "NC",
      "postal_code": "27613",
      "role": "site",
      "primary": true,
      "point": {
        "lat": 35.8492,
        "lon": -78.6996
      }
    }
  ],
  "owners": [
    {
      "name": "SMITH, JORDAN",
      "kind": {
        "code": "I",
        "description": "Individual"
      },
      "order": 1,
      "mailing_address": "PO BOX 1234, RALEIGH NC 27619-1234",
      "mailing_recipient": "TRIANGLE PROPERTY MANAGEMENT"
    }
  ],
  "assessment": {
    "tax_year": 2026,
    "class": {
      "code": "R",
      "description": "Residential"
    },
    "use": {
      "code": "SINGLFAM",
      "description": "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
      }
    ]
  },
  "building": {
    "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",
    "condition_code": "AV",
    "heating_type": "Forced air"
  },
  "sale": {
    "date": "2021-06-14",
    "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"
  },
  "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"
}