Skip to main content

Quickstart

Get a property valuation from the PadStats API in under 5 minutes.

1. Get your API key​

Sign up at dashboard.padstats.io to receive your API key.

2. Make your first request​

curl -X POST https://api.padstats.io/v1/avm/property \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "123 Main St, Austin, TX 78701",
    "property_type": "houses",
    "total_bedrooms": 3,
    "total_bathrooms": 2,
    "living_area": 1800,
    "year_built": 1998
  }'

3. Read the response​

{
  "address_info": {
    "formatted_address": "123 Main St, Austin, TX 78701",
    "street_address": "123 Main St",
    "city": "Austin",
    "state": "Texas",
    "state_code": "TX",
    "county": "Travis County",
    "postal_code": "78701",
    "latitude": 30.2672,
    "longitude": -97.7431,
    "geohash8": "9v6kn2pb",
    "census_geoids": {
      "state_fips": "48",
      "county_fips": "453",
      "tract_fips": "002100",
      "block_fips": "1"
    }
  },
  "valuation": {
    "point_value": 487000,
    "confidence_interval_95": {
      "lower": 452000,
      "upper": 522000
    },
    "probabilistic_distribution": {
      "mean": 487000,
      "std": 35700,
      "median": 485000
    }
  }
}

point_value is the estimated market value in dollars. confidence_interval_95 gives the 95% confidence range.

Other quick examples​

Get flood zone for a property:

curl "https://api.padstats.io/v1/flood-zone?address=123+Main+St,+Austin,+TX+78701" \
  -H "X-API-Key: YOUR_API_KEY"

Get multiple data types in one call:

curl -X POST https://api.padstats.io/v1/comprehensive \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requests": ["property-avm", "flood-zone", "fire-risk"],
    "address": "123 Main St, Austin, TX 78701",
    "beds": 3,
    "baths": 2,
    "living_area": 1800,
    "year_built": 1998,
    "property_type": "houses"
  }'

Next steps​