Skip to content

Get a parcel

GET
/v1/parcels/{id}
curl --request GET \
--url https://api.acresift.com/v1/parcels/37105012685 \
--header 'Authorization: Bearer <token>'

The parcel card: identity, size, owner and mailing address, tax value, last sale and building record.

id
required

ParcelKey

string
/^\d{1,15}$/
Example
37105012685

ParcelKey

The parcel

Media typeapplication/json
object
ParcelKey
required

Acresift’s id for the parcel. Stable while the county keeps the parcel

string
ParcelNumber
required

The county’s parcel number (APN / PIN), as the county writes it

string | null
CountyGEOID
required
string
CountyOrParish
required
string | null
StateOrProvince
required

USPS state code

string
SubdivisionCode
required

ISO 3166-2 code

string
Country
required

ISO 3166-1 alpha-2

string
Allowed values: US
UnparsedAddress
required

Situs (the land’s own) address

string | null
City
required

City of the situs address as the county records it (a postal name, not town limits)

string | null
IncorporatedMunicipality
required

Town or city whose limits contain the parcel’s centre; null = unincorporated

string | null
Latitude
required

WGS 84 decimal degrees, centre of the parcel

number | null
Longitude
required
number | null
BoundingBox
required

RFC 7946 bbox: [west, south, east, north] in WGS 84

Array<number> | null
LotSizeAcres
required

Area of the mapped outline (GIS acres), not the deeded acreage

number | null
LotSizeHectares
required
number | null
LotSizeSource
required
string
Allowed values: GIS
LandUseCode
required

The county’s land use / property class code, unmapped

string | null
StructurePresentYN
required

The county records a building on the parcel

boolean | null
TaxAssessedValue
required

County assessed (tax) value, total of land and buildings

number | null
CurrencyCode
required

ISO 4217 currency of every money field

string
Allowed values: USD
OwnerName
required

Owner of record (public record)

string | null
OwnerMailingAddress
required

Where the tax bill goes, one line as the county writes it

string | null
LastSale
required
object
ClosePrice
required

Recorded sale price

number | null
CloseDate
required

ISO 8601 date

string | null
CurrencyCode
required

ISO 4217

string
Allowed values: USD
MarketSaleYN
required

True when ClosePrice is $1,000 or more; lower amounts are gifts and other non-market transfers

boolean
DeedBook
required
string | null
DeedPage
required
string | null
Provenance
required
object
SourceId
required

Id of the row in GET /v1/sources

string | null
SourceName
required
string | null
AsOf
required

ISO 8601 date or date-time the value was last pulled or computed

string | null
Building
required
object
YearBuilt
required
integer | null
LivingArea
required

Heated living area

number | null
LivingAreaUnits
required
string
Allowed values: Square Feet
LivingAreaSquareMeters
required
number | null
BedroomsTotal
required
number | null
BathroomsTotalDecimal
required

Full baths plus 0.5 per half bath, as the county records it

number | null
StoriesTotal
required
number | null
StructureType
required

Building type as the county writes it (not yet mapped to the RESO list)

string | null
Provenance
required
object
SourceId
required

Id of the row in GET /v1/sources

string | null
SourceName
required
string | null
AsOf
required

ISO 8601 date or date-time the value was last pulled or computed

string | null
Provenance
required
object
SourceId
required

Id of the row in GET /v1/sources

string | null
SourceName
required
string | null
AsOf
required

ISO 8601 date or date-time the value was last pulled or computed

string | null
Example
{
"ParcelKey": "37105012685",
"ParcelNumber": "954732057500",
"CountyGEOID": "37105",
"CountyOrParish": "Lee",
"StateOrProvince": "NC",
"SubdivisionCode": "US-NC",
"Country": "US",
"UnparsedAddress": "2021 COLON RD",
"Latitude": 35.47,
"Longitude": -79.18,
"LotSizeAcres": 17.49,
"LotSizeSource": "GIS",
"CurrencyCode": "USD",
"LastSale": {
"ClosePrice": 185000,
"CloseDate": "2021-06-14",
"CurrencyCode": "USD",
"Provenance": {
"SourceId": "metrics:37105",
"SourceName": "Site metrics: FEMA flood, NWI wetlands, 3DEP slope, NCDOT roads",
"AsOf": "2026-09-22"
}
},
"Building": {
"LivingArea": 1850,
"LivingAreaUnits": "Square Feet",
"Provenance": {
"SourceId": "metrics:37105",
"SourceName": "Site metrics: FEMA flood, NWI wetlands, 3DEP slope, NCDOT roads",
"AsOf": "2026-09-22"
}
},
"Provenance": {
"SourceId": "metrics:37105",
"SourceName": "Site metrics: FEMA flood, NWI wetlands, 3DEP slope, NCDOT roads",
"AsOf": "2026-09-22"
}
}

The request did not validate; errors lists each bad field

Media typeapplication/problem+json

RFC 9457 problem details (served as application/problem+json)

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
errors

Validation problems, one per bad field

Array<object>
object
path
required
string
message
required
string
Example
{
"type": "https://acresift.com/docs/api/errors#not_found",
"title": "Not found",
"status": 404,
"detail": "No parcel 37105012685."
}

Missing, wrong or revoked API key

Media typeapplication/problem+json

RFC 9457 problem details (served as application/problem+json)

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
errors

Validation problems, one per bad field

Array<object>
object
path
required
string
message
required
string
Example
{
"type": "https://acresift.com/docs/api/errors#not_found",
"title": "Not found",
"status": 404,
"detail": "No parcel 37105012685."
}

No parcel with that key

Media typeapplication/problem+json

RFC 9457 problem details (served as application/problem+json)

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
errors

Validation problems, one per bad field

Array<object>
object
path
required
string
message
required
string
Example
{
"type": "https://acresift.com/docs/api/errors#not_found",
"title": "Not found",
"status": 404,
"detail": "No parcel 37105012685."
}

Rate limit reached; wait Retry-After seconds

Media typeapplication/problem+json

RFC 9457 problem details (served as application/problem+json)

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
errors

Validation problems, one per bad field

Array<object>
object
path
required
string
message
required
string
Example
{
"type": "https://acresift.com/docs/api/errors#not_found",
"title": "Not found",
"status": 404,
"detail": "No parcel 37105012685."
}