hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "fair_market_rent": {
          "description": "HUD fair market rents (rent plus utilities); null when unavailable.",
          "properties": {
            "area": {
              "description": "HUD fair market rent area.",
              "examples": [
                "Washington-Arlington-Alexandria, DC-VA-MD HUD Metro FMR Area"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "four_bedroom": {
              "description": "4 bedrooms.",
              "examples": [
                3332
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "one_bedroom": {
              "description": "1 bedroom.",
              "examples": [
                2015
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "studio": {
              "description": "Studio, USD/month.",
              "examples": [
                1953
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "three_bedroom": {
              "description": "3 bedrooms.",
              "examples": [
                2835
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "two_bedroom": {
              "description": "2 bedrooms.",
              "examples": [
                2246
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "zip": {
              "description": "HUD Small Area (ZIP) fair market rents; null outside metro areas that publish them.",
              "properties": {
                "four_bedroom": {
                  "description": "4 bedrooms.",
                  "examples": [
                    3070
                  ],
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "one_bedroom": {
                  "description": "1 bedroom.",
                  "examples": [
                    1860
                  ],
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "studio": {
                  "description": "Studio.",
                  "examples": [
                    1720
                  ],
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "three_bedroom": {
                  "description": "3 bedrooms.",
                  "examples": [
                    2610
                  ],
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "two_bedroom": {
                  "description": "2 bedrooms.",
                  "examples": [
                    2070
                  ],
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "zip": {
                  "description": "ZIP.",
                  "examples": [
                    "20746"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "zip",
                "studio",
                "one_bedroom",
                "two_bedroom",
                "three_bedroom",
                "four_bedroom"
              ],
              "type": [
                "object",
                "null"
              ]
            }
          },
          "required": [
            "area",
            "studio",
            "one_bedroom",
            "two_bedroom",
            "three_bedroom",
            "four_bedroom",
            "zip"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "geography": {
          "description": "Where the address sits (Census Geocoder).",
          "properties": {
            "block_group": {
              "description": "Block group GEOID.",
              "examples": [
                "240338024052"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "congressional_district": {
              "description": "Congressional district.",
              "examples": [
                "Congressional District 4"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "county": {
              "description": "County.",
              "examples": [
                "Prince George's County"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "county_fips": {
              "description": "County FIPS.",
              "examples": [
                "24033"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "metro": {
              "description": "Metropolitan or micropolitan area.",
              "examples": [
                "Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "metro_code": {
              "description": "CBSA code.",
              "examples": [
                "47900"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "place": {
              "description": "City or census-designated place.",
              "examples": [
                "Suitland CDP"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "school_district": {
              "description": "School district.",
              "examples": [
                "Prince George's County Public Schools"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "state": {
              "description": "State.",
              "examples": [
                "Maryland"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "state_fips": {
              "description": "State FIPS.",
              "examples": [
                "24"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "tract": {
              "description": "Census tract GEOID.",
              "examples": [
                "24033802405"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "zip": {
              "description": "ZIP code tabulation area.",
              "examples": [
                "20746"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "state",
            "state_fips",
            "county",
            "county_fips",
            "tract",
            "block_group",
            "place",
            "zip",
            "metro",
            "metro_code",
            "congressional_district",
            "school_district"
          ],
          "type": "object"
        },
        "hazard_risk": {
          "description": "FEMA National Risk Index for the tract; null when unavailable.",
          "properties": {
            "community_resilience": {
              "description": "Community resilience rating.",
              "examples": [
                "Relatively Low"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "expected_annual_loss_usd": {
              "description": "Expected annual loss for the tract, all hazards.",
              "examples": [
                401271
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "hazards": {
              "additionalProperties": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "description": "Rating per hazard (18 hazards); null where FEMA does not rate it.",
              "examples": [
                {
                  "heat_wave": "Relatively Moderate",
                  "hurricane": "Relatively Low",
                  "riverine_flooding": "Very Low"
                }
              ],
              "type": "object"
            },
            "notice": {
              "description": "FEMA's required notice.",
              "examples": [
                "This product uses the Federal Emergency Management Agency's National Risk Index..."
              ],
              "type": "string"
            },
            "overall_rating": {
              "description": "Composite risk rating.",
              "examples": [
                "Very Low"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "overall_score": {
              "description": "Composite risk score (0-100 percentile).",
              "examples": [
                7.41
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "social_vulnerability": {
              "description": "Social vulnerability rating.",
              "examples": [
                "Relatively High"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "version": {
              "description": "National Risk Index release.",
              "examples": [
                "December 2025"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "overall_rating",
            "overall_score",
            "expected_annual_loss_usd",
            "social_vulnerability",
            "community_resilience",
            "hazards",
            "version",
            "notice"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "housing": {
          "description": "Census tract housing and income figures; null when the tract has none.",
          "properties": {
            "level": {
              "description": "Geography of the figures.",
              "examples": [
                "census tract"
              ],
              "type": "string"
            },
            "median_gross_rent": {
              "description": "Median gross rent, USD per month.",
              "examples": [
                1486
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "median_home_value": {
              "description": "Median value of owner-occupied homes, USD.",
              "examples": [
                332200
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "median_home_value_moe": {
              "description": "Margin of error of that median, USD.",
              "examples": [
                24540
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "median_household_income": {
              "description": "Median household income, USD.",
              "examples": [
                70286
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "median_year_built": {
              "description": "Median year homes were built.",
              "examples": [
                1969
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "owner_occupied_pct": {
              "description": "Share of occupied homes that are owner-occupied, %.",
              "examples": [
                30.3
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "population": {
              "description": "Population.",
              "examples": [
                3053
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "survey": {
              "description": "Which survey.",
              "examples": [
                "ACS 5-year estimates 2020-2024 (Census Bureau)"
              ],
              "type": "string"
            },
            "vacancy_pct": {
              "description": "Share of housing units vacant, %.",
              "examples": [
                16.8
              ],
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "median_home_value",
            "median_home_value_moe",
            "median_gross_rent",
            "median_household_income",
            "population",
            "owner_occupied_pct",
            "median_year_built",
            "vacancy_pct",
            "survey",
            "level"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "input": {
          "description": "What was asked.",
          "properties": {
            "address": {
              "description": "Address as sent; null when a point was sent.",
              "examples": [
                "4600 Silver Hill Rd, Washington, DC 20233"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "lat": {
              "description": "Latitude as sent; null when an address was sent.",
              "examples": [
                38.845
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "lng": {
              "description": "Longitude as sent; null when an address was sent.",
              "examples": [
                -76.928
              ],
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "address",
            "lat",
            "lng"
          ],
          "type": "object"
        },
        "lat": {
          "description": "Latitude used.",
          "examples": [
            38.84505589808
          ],
          "type": "number"
        },
        "lng": {
          "description": "Longitude used.",
          "examples": [
            -76.92836638093
          ],
          "type": "number"
        },
        "matched_address": {
          "description": "The Census Geocoder's standardised match; null for a point.",
          "examples": [
            "4600 SILVER HILL RD, WASHINGTON, DC, 20233"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "notes": {
          "description": "Caveats; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "FEMA has no digital flood map at this point."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "price_trend": {
          "description": "Tract house price trend; null when FHFA publishes none for the tract.",
          "properties": {
            "annual_change_pct": {
              "description": "Change in that year, %.",
              "examples": [
                9.46
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "five_year_change_pct": {
              "description": "Change over the five years to it, %.",
              "examples": [
                28.31
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "latest_year": {
              "description": "Latest year with an index value.",
              "examples": [
                2025
              ],
              "type": "integer"
            },
            "source": {
              "description": "Which index.",
              "examples": [
                "FHFA House Price Index, annual, census tract"
              ],
              "type": "string"
            }
          },
          "required": [
            "latest_year",
            "annual_change_pct",
            "five_year_change_pct",
            "source"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "school_radius_km": {
          "description": "Radius searched for schools.",
          "examples": [
            1.5
          ],
          "type": "number"
        },
        "schools": {
          "description": "Public schools within the radius, nearest first.",
          "examples": [
            []
          ],
          "items": {
            "description": "A public school (NCES 2024-25).",
            "properties": {
              "charter": {
                "description": "Charter school.",
                "examples": [
                  false
                ],
                "type": "boolean"
              },
              "city": {
                "description": "City.",
                "examples": [
                  "Suitland"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_km": {
                "description": "Straight-line distance.",
                "examples": [
                  0.88
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "district": {
                "description": "District.",
                "examples": [
                  "Prince George's County Public Schools"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "enrollment": {
                "description": "Students enrolled.",
                "examples": [
                  514
                ],
                "type": [
                  "integer",
                  "null"
                ]
              },
              "grades": {
                "description": "Grade span.",
                "examples": [
                  "PK-05"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "level": {
                "description": "Level.",
                "examples": [
                  "Elementary"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "description": "School.",
                "examples": [
                  "Suitland Elementary"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "students_per_teacher": {
                "description": "Students per teacher.",
                "examples": [
                  14.94
                ],
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "level",
              "grades",
              "enrollment",
              "students_per_teacher",
              "charter",
              "district",
              "city",
              "distance_km"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "sections_failed": {
          "description": "Sections that could not be fetched this time; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A section whose source did not answer; that section is null or empty.",
            "examples": [
              "walkability"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "sources": {
          "description": "Every source this answer draws on.",
          "items": {
            "description": "A source.",
            "properties": {
              "name": {
                "description": "Source.",
                "examples": [
                  "FEMA National Flood Hazard Layer"
                ],
                "type": "string"
              },
              "url": {
                "description": "Where it is published.",
                "examples": [
                  "https://www.fema.gov/flood-maps/national-flood-hazard-layer"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "superfund_radius_km": {
          "description": "Radius searched for Superfund sites.",
          "examples": [
            5
          ],
          "type": "number"
        },
        "superfund_sites": {
          "description": "Superfund sites within the radius, nearest first.",
          "examples": [
            []
          ],
          "items": {
            "description": "A Superfund (NPL) site.",
            "properties": {
              "address": {
                "description": "Address.",
                "examples": [
                  "3617 BAER STREET"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "city": {
                "description": "City.",
                "examples": [
                  "HOUSTON"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_km": {
                "description": "Straight-line distance.",
                "examples": [
                  4.61
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "name": {
                "description": "Site.",
                "examples": [
                  "SAN JACINTO FOUNDRY"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "state": {
                "description": "State.",
                "examples": [
                  "TX"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "description": "NPL status.",
                "examples": [
                  "CURRENTLY ON THE FINAL NPL"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "description": "EPA facility page.",
                "examples": [
                  "https://ofmpub.epa.gov/frs_public2/fii_query_detail.disp_program_facility?p_registry_id=110005037361"
                ],
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "address",
              "city",
              "state",
              "status",
              "url",
              "distance_km"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "walkability": {
          "description": "EPA walkability; null when unavailable.",
          "properties": {
            "block_group": {
              "description": "Block group the index describes.",
              "examples": [
                "240338024051"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "index": {
              "description": "EPA National Walkability Index, 1 (least) to 20 (most).",
              "examples": [
                11.33
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "meters_to_transit": {
              "description": "Distance to the nearest transit stop, metres.",
              "examples": [
                926.71
              ],
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "index",
            "meters_to_transit",
            "block_group"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "input",
        "matched_address",
        "lat",
        "lng",
        "geography",
        "hazard_risk",
        "housing",
        "price_trend",
        "fair_market_rent",
        "schools",
        "school_radius_km",
        "walkability",
        "superfund_sites",
        "superfund_radius_km",
        "sources",
        "sections_failed",
        "notes",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "property.context response",
  "type": "object"
}