Real Estate API

Property Parcel and Boundary Information

POST /v1/PropertyParcel
Api key

Get property parcel boundaries and information in GeoJSON format. Perfect for mapping applications showing property boundaries.

Headers

  • x-api-key string Required

    API key for authentication

  • x-user-id string

    Optional user identifier for tracking and analytics

application/json

Body Required

Property parcel request

  • id string | integer

    Unique property identifier

    One of:
    string-1 string integer-2 integer
  • address string

    Full property address

    Minimum length is 5.

  • apn string

    Assessor's Parcel Number

  • house string

    House number

  • street string

    Street name

  • city string

    City name

  • state string

    State abbreviation

    Format should match the following pattern: ^[A-Z]{2}$.

  • zip string

    ZIP code

    Format should match the following pattern: ^[0-9]{5}(-[0-9]{4})?$.

  • county string

    County name

Responses

  • 200 application/json

    Successful response with property parcel data

    Hide response attributes Show response attributes object
    • input object

      Echo of the input parameters

    • data object

      Property parcel data with GeoJSON boundaries

      Hide data attributes Show data attributes object
      • id string

        Property identifier

      • address object

        Property address information

      • apn string

        Assessor's Parcel Number

      • geometry object

        GeoJSON geometry for property boundaries

        Hide geometry attributes Show geometry attributes object
        • type string

          Values are Polygon or MultiPolygon.

        • coordinates array

          GeoJSON coordinate arrays

      • properties object

        Additional property metadata

        Hide properties attributes Show properties attributes object
        • acres number

          Property size in acres

        • sqft number

          Property size in square feet

    • statusCode integer

      HTTP status code

    • live boolean

      Indicates if data is live
  • 400 application/json

    Bad Request - Invalid input parameters

    Hide response attributes Show response attributes object
    • error string
    • message string
    • statusCode integer
    • details object

      Additional error details
  • 401 application/json

    Unauthorized - Invalid or missing API key

    Hide response attributes Show response attributes object
    • error string
    • message string
    • statusCode integer
  • 404 application/json

    Not Found - Resource not found

    Hide response attributes Show response attributes object
    • error string
    • message string
    • statusCode integer
  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • error string
    • message string
    • statusCode integer
POST /v1/PropertyParcel 
curl \
 --request POST 'https://api.realestateapi.com/v1/PropertyParcel' \
 --header "Content-Type: application/json" \
 --header "x-api-key: string" \
 --header "x-user-id: string" \
 --data '{"id":"148046016"}'
Request examples 
{
  "id": "148046016"
}
{
  "state": "GA",
  "county": "Fulton",
  "address": "2025 Peachtree Rd NE, Atlanta GA 30309"
}
Response examples (200) 
{
  "data": {
    "id": "148046016",
    "apn": "170110LL0333",
    "address": {
      "zip": "30309",
      "city": "Atlanta",
      "state": "GA",
      "county": "Fulton",
      "street": "2025 Peachtree Rd NE",
      "address": "2025 Peachtree Rd NE, Atlanta GA 30309"
    },
    "geometry": {
      "type": "Polygon",
      "coordinates": [
        [
          [
            -84.387901,
            33.748912
          ],
          [
            -84.387801,
            33.748912
          ],
          [
            -84.387801,
            33.749012
          ],
          [
            -84.387901,
            33.749012
          ],
          [
            -84.387901,
            33.748912
          ]
        ]
      ]
    },
    "properties": {
      "sqft": 10890,
      "acres": 0.25
    }
  },
  "live": true,
  "input": {
    "id": "148046016"
  },
  "statusCode": 200
}
Response examples (400) 
{
  "error": "Bad Request",
  "message": "Invalid input parameters",
  "statusCode": 400,
  "details": {}
}
Response examples (401) 
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "statusCode": 401
}
Response examples (404) 
{
  "error": "Not Found",
  "message": "Property not found",
  "statusCode": 404
}
Response examples (500) 
{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred",
  "statusCode": 500
}