REST reference

Soon[3 endpoints]View as Markdown

Hazards

US natural-hazard risk — FEMA National Risk Index county and census-tract profiles, components, and rankings.

Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.

GET/v1/hazards/hazard-components

Hazard Components

Return a bounded page of one geography's FEMA NRI hazard components.

Parameters

NameTypeRequiredDefaultConstraintsDescription
geographystringYes——County/tract name, FIPS, or geo_key
hazard_typestring | nullNo——Optional FEMA hazard code or display name
limitintegerNo10min 1, max 18Hazard components to return
cursorstring | nullNo——Opaque cursor from pagination.next_cursor

Example request

Required parameters only, with values taken from the schema. Optional parameters are in the table above.

[ BASH ]
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/hazards/hazard-components?geography=GEOGRAPHY"

Response

200 Successful Response · expand a branch to see its fields.

  • dataHazardComponentsDatarequired
    • geographyHazardGeographyRefrequired
      • geo_keystringrequired
      • level"county" | "tract"required
      • fipsstringrequired
      • namestringrequired
      • state_codestringrequirednullable
    • hazard_typestringrequirednullable
    • unitsHazardComponentUnits
      • risk_score"score"default "score"
      • risk_value"index_value"default "index_value"
      • eal_total"USD/year"default "USD/year"
      • eal_score"score"default "score"
    • componentsarray<HazardComponent>required
      • hazard_codestringrequired
      • hazard_namestringrequired
      • risk_scorestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
      • risk_ratingstringrequirednullable
      • risk_valuestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
      • eal_totalstringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
      • eal_scorestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
      • eal_ratingstringrequirednullable
  • metaHazardReleaseMetarequired
    • sourcestringrequired
    • as_ofstring (date-time) | string (date)nullable
    • period_type"annual"default "annual"
    • currency"USD"default "USD"
    • release_versionstringrequired
    • release_datestring (date)required
  • paginationPaginationnullable
    • limitintegerrequired
    • has_morebooleanrequired
    • next_cursorstringnullable

GET/v1/hazards/rankings

Rankings

Rank county or tract profiles by a FEMA NRI metric.

Parameters

NameTypeRequiredDefaultConstraintsDescription
level"county" | "tract"Yes——Geography level to rank: county or tract
metricstringYes——Composite or hazard-specific FEMA NRI metric
statestring | nullNo——Optional state name, postal abbreviation, FIPS, or geo_key
limitintegerNo10min 1, max 100Ranked geographies to return
cursorstring | nullNo——Opaque cursor from pagination.next_cursor

Example request

Required parameters only, with values taken from the schema. Optional parameters are in the table above.

[ BASH ]
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/hazards/rankings?level=LEVEL&metric=METRIC"

Response

200 Successful Response · expand a branch to see its fields.

  • dataHazardRankingsDatarequired
    • level"county" | "tract"required
    • metricstringrequired
    • metric_unitstringrequired
    • stateHazardStateRefrequirednullable
      • geo_keystringrequired
      • codestringrequired
      • namestringrequired
      • state_codestringrequired
    • rankingsarray<HazardRankingItem>required
      • rankintegerrequired
      • geographyHazardGeographyRefrequired
        • geo_keystringrequired
        • level"county" | "tract"required
        • fipsstringrequired
        • namestringrequired
        • state_codestringrequirednullable
      • metric_valuestringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
      • ratingstringrequirednullable
      • release_versionstringrequired
      • release_datestring (date)required
      • as_ofstring (date-time)required
  • metaHazardRankingMetarequired
    • sourcestringrequired
    • as_ofstring (date-time) | string (date)nullable
    • period_type"annual"default "annual"
    • currency"USD"default "USD"
  • paginationPaginationnullable
    • limitintegerrequired
    • has_morebooleanrequired
    • next_cursorstringnullable

GET/v1/hazards/risk-profile

Risk Profile

Return one county or census tract's newest FEMA NRI profile.

Parameters

NameTypeRequiredDefaultConstraintsDescription
geographystringYes——County/tract name, FIPS, or geo_key

Example request

Required parameters only, with values taken from the schema. Optional parameters are in the table above.

[ BASH ]
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/hazards/risk-profile?geography=GEOGRAPHY"

Response

200 Successful Response · expand a branch to see its fields.

  • dataHazardRiskProfileDatarequired
    • geographyHazardGeographyRefrequired
      • geo_keystringrequired
      • level"county" | "tract"required
      • fipsstringrequired
      • namestringrequired
      • state_codestringrequirednullable
    • unitsHazardValueUnits
      • risk_score"score"default "score"
      • risk_value"index_value"default "index_value"
      • risk_percentile"percentile"default "percentile"
      • eal_total"USD/year"default "USD/year"
      • eal_score"score"default "score"
      • eal_percentile"percentile"default "percentile"
      • sovi_score"score"default "score"
      • resl_score"score"default "score"
      • population"people"default "people"
      • building_value"USD"default "USD"
      • agriculture_value"USD"default "USD"
    • risk_scorestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • risk_ratingstringrequirednullable
    • risk_valuestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • risk_percentilestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • eal_totalstringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • eal_scorestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • eal_ratingstringrequirednullable
    • eal_percentilestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • sovi_scorestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • sovi_ratingstringrequirednullable
    • resl_scorestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • resl_ratingstringrequirednullable
    • populationintegerrequirednullable
    • building_valuestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
    • agriculture_valuestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
  • metaHazardReleaseMetarequired
    • sourcestringrequired
    • as_ofstring (date-time) | string (date)nullable
    • period_type"annual"default "annual"
    • currency"USD"default "USD"
    • release_versionstringrequired
    • release_datestring (date)required
  • paginationPaginationnullable
    • limitintegerrequired
    • has_morebooleanrequired
    • next_cursorstringnullable