parcel

Resolve a batch of parcels

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

post/v1/parcel/batch

Request

  • Base URL: http://localhost:3030
  • URL: http://localhost:3030/v1/parcel/batch
  • Auth: HTTP bearer

Request body

Example request

{
  "item": [
    {
      "address": "4516 Printer Ln, Raleigh, NC 27613",
      "apn": "1717353946",
      "jurisdiction": "jur_01h455vb4pex5vsknk084sn02q",
      "fips": "37183",
      "lat": 35.8492,
      "lon": -78.6996,
      "parcel": "prc_01h455vb4pex5vsknk084sn02q"
    }
  ]
}

Response

The parcel batch.

object'parcel_batch' required

The object's type. Always parcel_batch.

matchedinteger required

Number of lookups with status matched.

ambiguousinteger required

Number of lookups with status ambiguous.

unmatchedinteger required

Number of lookups with status unmatched.

invalidinteger required

Number of lookups with status invalid.

Example response

{
  "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"
      },
      "detail": "`apn` requires `jurisdiction` or `fips`.",
      "candidates": 1,
      "match": {
        "score": 1,
        "matched": "4516 PRINTER LN, RALEIGH NC 27613"
      },
      "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": "RHS",
          "description": "Residential Less Than 10 Acres",
          "standard": "residential"
        },
        "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": "RHS",
              "description": "Residential Less Than 10 Acres",
              "standard": "residential"
            },
            "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": "RHS",
            "description": "Residential Less Than 10 Acres",
            "standard": "residential.single_family"
          },
          "use": {
            "code": "RHS",
            "description": "Residential Less Than 10 Acres",
            "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": "RHS",
              "description": "Residential Less Than 10 Acres",
              "standard": "residential"
            },
            "book": "018512",
            "page": "01177",
            "qualification": {
              "code": "RHS",
              "description": "Residential Less Than 10 Acres",
              "standard": "residential"
            },
            "grantor": "JOHNSON, TAYLOR",
            "grantee": "RIVERA, SAM",
            "transfer_tax": 970,
            "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": {
          "score": 1,
          "matched": "4516 PRINTER LN, RALEIGH NC 27613"
        },
        "as_of": "2026-10-01",
        "href": "/v1/parcel/prc_01h455vb4pex5vsknk084sn02q"
      }
    }
  ],
  "matched": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.