name: Estated Property Lookup
description: >-
  Look up a U.S. property record by address (split, parsed, or combined) or
  by FIPS+APN and return the full Estated Property object including parcel,
  structure, taxes, assessments, valuation, owner, deeds, and parcel boundary.
provider: estated
api: property-data-api
version: 0.1
operations:
  - operationId: getProperty
    method: GET
    path: /v4/property
    summary: Look up a property by address or parcel identifier
inputs:
  - name: token
    type: string
    required: true
    secret: true
    description: Estated / ATTOM API token.
  - name: combined_address
    type: string
    description: Single comma-separated address string.
  - name: street_address
    type: string
    description: Full street address line (number + name + suffix).
  - name: city
    type: string
  - name: state
    type: string
  - name: zip_code
    type: string
  - name: fips
    type: string
    description: 5-digit FIPS county code (use with apn).
  - name: apn
    type: string
    description: Assessor parcel number (use with fips).
outputs:
  - name: data
    description: Property object with address, parcel, structure, taxes, assessments, valuation, owner, deeds, and boundary.
  - name: metadata
    description: attom_id and publishing_date for the returned record.
  - name: warnings
    description: PW01, PW02, APW01, APW02 — non-billable in most cases.
errors:
  - code: APE01
    description: Address parser error.
  - code: ISE01-ISE09
    description: Internal server error.
  - code: EE01
    description: Endpoint not found.
  - code: RE01
    description: Insufficient parameters.
  - code: RE02
    description: Parameter rule violation.
  - code: RE03
    description: Request too large.
  - code: RE04
    description: Throttled.
  - code: RE05
    description: Invalid request.
  - code: RE06
    description: Method not allowed (only GET and OPTIONS).
  - code: AE02
    description: Invalid token.
  - code: AE03
    description: Token has no calls remaining.
  - code: AE04
    description: Token deactivated.
governance:
  authentication: api_key_in_query
  rate_limit: provider-enforced (RE04 returned on throttle)
  billing: per-successful-match (warnings PW01/PW02/APW01 are non-billable)
tags:
  - PropertyData
  - RealEstate
  - AVM
  - Parcels
  - Deeds