Main Changes in v3 of API

Version 3 (v3) of our API includes the following changes.

Most users will switch from v1 directly to v3. While the documentation for v3 may be harder to read for a general reader, it follows an industry standard and is very easy for a programmer to use.

v3 is thoroughly documented here, and the list below is intended as a user-friendly overview.

  • The API returns a 200 status code only when a data response is provided. If data is not returned because the address or parcel could not be found a 404 status code is returned.
  • The format of the main flood data results is unchanged, in particular the FEMA flood zone layers are presented in the same manner as earlier versions.
  • The community data is now collected in a dictionary instead of multiple individual entries.
  • The census bureau data is now collected in a dictionary instead of multiple individual entries.
  • The three datasets elevation, property and parcel that require an additional access are now all contained within the same API. If a user's key does not include access to this data, the data will not be provided.
  • The query parameter getbfe has been replaced by the parameter elevation to be consistent with property and parcel.
  • The endpoint floodmap has been renamed floodmapraw to make clear that this endpoint returns raw data and not a map.
  • The fields returned in the geocode section have changed.
  • The paths for the static and dynamic maps have changed, but the maps themselves remain the same.
  • The data API no longer contains a preformatted url to access the static map. The user must now query query the static map directly. The coordinates returned by the API may be used in the request to the static map endpoint.


National Flood Data was started in 2016 with two contracts to build a reliable flood data service for two real estate data companies. Insurance companies began turning to us shortly afterwards and are now our primary customers. Our approach is very simple: we provide a very reliable, accurate and easy-to-use service and our customers tell us what they need next. We are located in Seattle, Washington. When you call us, we answer the phone.




Copyright2016-2022National Flood Data. All rights reserved.