Skip to main content
All providers

FEMA USA Structures

GeoUS

services2.arcgis.com

Building-level footprints for structures across the United States and its territories, produced by Oak Ridge National Laboratory for FEMA, with occupancy class, primary use, address, height, floor area, elevation, county and census tract codes and a modelled building population estimate.

Capabilities (15)

GET /v1/data/usastructures/count1 credit

Returns a single JSON object with the number of buildings matching a SQL where clause, with no rows.

where
GET /v1/data/usastructures/count-in-bbox1 credit

Returns a single JSON object with the number of buildings intersecting a WGS84 bounding box.

xminyminxmaxymaxwhere?
GET /v1/data/usastructures/distinct-values1 credit

Returns the distinct values present in one or more fields across the buildings matching a where clause.

whereoutFieldsorderByFields?resultRecordCount?resultOffset?
GET /v1/data/usastructures/extent1 credit

Returns only the WGS84 extent (xmin, ymin, xmax, ymax), covering every building matching a where clause.

where
GET /v1/data/usastructures/footprints-in-bbox1 credit

Returns a GeoJSON FeatureCollection of building outline polygons intersecting a WGS84 bounding box, each carrying the full attribute set.

xminyminxmaxymaxwhere?resultOffset?
GET /v1/data/usastructures/footprints-near-point1 credit

Returns a GeoJSON FeatureCollection of building outline polygons within a radius in metres of a longitude/latitude, each carrying the full attribute set.

longitudelatitudedistancewhere?resultOffset?
GET /v1/data/usastructures/in-bbox1 credit

Returns every building intersecting a WGS84 bounding box, with all attributes and no geometry.

xminyminxmaxymaxwhere?orderByFields?resultOffset?
GET /v1/data/usastructures/layer-metadata1 credit

Returns the structures layer definition: all 36 field names with their types, aliases and official FEMA field descriptions, plus the layer extent and drawing info.

No parameters
GET /v1/data/usastructures/near-point1 credit

Returns every building whose footprint falls within a given radius in metres of a longitude/latitude, with all attributes and no geometry.

longitudelatitudedistancewhere?orderByFields?resultOffset?
GET /v1/data/usastructures/object-ids1 credit

Returns just the OBJECTID list for the buildings matching a where clause, with no attributes and no geometry.

where
GET /v1/data/usastructures/search1 credit

Runs a SQL where clause against the structures table and returns matching buildings with all attributes and no geometry.

whereorderByFields?resultRecordCount?resultOffset?
GET /v1/data/usastructures/service-metadata1 credit

Returns the feature service descriptor: layer list, maxRecordCount, full extent, spatial reference and the query capabilities the service supports.

No parameters
GET /v1/data/usastructures/statistics1 credit

Runs server-side aggregates (count, sum, min, max, avg, stddev, percentile) over the buildings matching a where clause, optionally grouped by one or more fields.

whereoutStatisticsgroupByFieldsForStatistics?orderByFields?having?resultRecordCount?
GET /v1/data/usastructures/structure1 credit

Returns the single building record with the given GlobalID, including its UUID, address, occupancy, height, floor area, elevation range and population estimate.

global_id
GET /v1/data/usastructures/top-features1 credit

Returns the top N buildings within each group (for example the tallest building in every county) using the service's queryTopFeatures operation.

wheretopFilter

Response example

The shape of data from usastructures/count (Count structures matching a filter). A sample, not live data.

JSON
{
  "count": 367168
}

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • Count structures matching a filter

    Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Count structures matching a filter" (count). You only need how many buildings match - a state, county, ZIP or occupancy type - and not the records themselves. Example options: where=PROP_ST='Rhode Island'. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "count". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Count structures in a bounding box

    Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Count structures in a bounding box" (count-in-bbox). You want building density or a feasibility check for a map area before pulling the records, which may exceed the 2000-row page. Example options: xmin=-105.2805, ymin=40.0100, xmax=-105.2700. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "count-in-bbox". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Distinct values of a field

    Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Distinct values of a field" (distinct-values). You need the real vocabulary of a field - which occupancy types, counties or building codes actually occur - before writing a filter. Example options: where=STATE_FIPS='44', outFields=PRIM_OCC, orderByFields=PRIM_OCC. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "distinct-values". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Bounding box of a result set

    Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Bounding box of a result set" (extent). You want to know where a set of buildings sits, or to fit a map to it, without downloading any features. Example options: where=FIPS='44003'. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "extent". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

Licence

Item licence statement on the authoritative "USA Structures" layer (ArcGIS item 0ec8512ad21e4bb987d7e848d14e7e24), verbatim: "This work is licensed under a Creative Commons by Attribution (CC BY 4.0) license. See Credits and Map for Attribution." with links headed "View License Deed" (https://creativecommons.org/licenses/by/4.0) and "View Legal Code" (https://creativecommons.org/licenses/by/4.0/legalcode). The same item's credits field reads: "Oak Ridge National Laboratory (ORNL); Federal Emergency Management Agency (FEMA) Geospatial Response Office". CC BY 4.0 grants, in its own words, the right to "copy and redistribute the material in any medium or format" and to "remix, transform, and build upon the material for any purpose, even commercially", provided attribution is given.

https://creativecommons.org/licenses/by/4.0/

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

USA Structures - Oak Ridge National Laboratory (ORNL) and FEMA Geospatial Response Office, hosted by Esri U.S. Federal Datasets, CC BY 4.0

Cache: up to 3600s