Documentation menu

← Parcels

API reference

Resolve a batch of parcels

POST/v1/parcel/batch

Looks up many parcels in one request, each by address, parcel number or point. Results come back in the order sent.

Parameters

No parameters.

Request body

itemrequiredLocator[]
The lookups, between 1 and 500.
Show fields
addressstring | null
A street address, with city or postal code where known. A state or city in the address limits matches to parcels there.
apnstring | null
A parcel number, as published. Requires jurisdiction or fips.
jurisdictionstring | null
A jurisdiction id. The assessor of apn, or the area to search within.
fipsstring | null
A Census GEOID: 2 digits for a state or 5 for a county. The county of apn, or the area to search within.
latnumber | null
Latitude, in WGS 84. Requires lon.
lonnumber | null
Longitude, in WGS 84. Requires lat.
parcelstring | null
A parcel id.

Responses

200
Batch
The parcel batch.
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 match. Repeat requests within 24 hours are free.

Example request

curl -X POST 'https://api.placestack.com/v1/parcel/batch' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "item": [
    {
      "address": "4516 Printer Ln, Raleigh, NC 27613"
    }
  ]
}'

Example response

{
  "object": "parcel_batch",
  "item": [
    {
      "input": {
        "address": "4516 Printer Ln, Raleigh, NC 27613",
        "apn": "1717353946",
        "jurisdiction": "jur_01h455vb4pex5vsknk084sn02q",
        "fips": "37183",
        "lat": 35.8492,
        "lon": -78.6996,
        "parcel": "prc_01h455vb4pex5vsknk084sn02q"
      },
      "status": "matched",
      "detail": "`apn` requires `jurisdiction` or `fips`.",
      "candidates": 1,
      "match": {
        "method": "address",
        "score": 1,
        "matched": "4516 PRINTER LN, RALEIGH NC 27613"
      },
      "parcel": {
        "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"
      }
    }
  ],
  "matched": 1,
  "ambiguous": 0,
  "unmatched": 0,
  "invalid": 0
}

Next steps

GET /parcel/{parcel_id}

Retrieve a parcel

Continue