{"uid":"cap_OpFIa6ndW7goA3qzFh9lo","slug":"2s-location-dossier-api-4f934479","name":"2s Location Dossier API","description":"Static risk & context dossier for a US location. Pass lat+lon or a US address (geocoded for you). Composes five authoritative, keyless federal sources into one answer an agent cannot derive from training: Census place context (county, state, census tract, congressional district), FEMA flood zone + Special-Flood-Hazard-Area status, USGS ASCE 7-16 seismic design parameters (Ss, S1, SDS, SD1, seismic design category, PGA), the nearest NOAA/GHCN climate station, and — when a zip is supplied — US Census ACS 5-year demographics. Each layer is isolated: one source failing does not fail the rest. This is the slow-moving structural-risk picture (siting, insurance, due diligence), distinct from real-time weather/earthquake conditions.","url":"https://2s.io/api/geo/location-dossier","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":[],"properties":{"lat":{"type":"string","description":"Latitude (WGS84). Provide with lon, or use address."},"lon":{"type":"string","description":"Longitude (WGS84). Provide with lat, or use address."},"zip":{"type":"string","description":"Optional 5-digit ZIP to include ACS demographics."},"address":{"type":"string","description":"US street address (alternative to lat/lon)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"zip":"94043","address":"1600 Amphitheatre Parkway, Mountain View, CA"}}},"response":{"data":{"note":"Independent authoritative US sources composed on the coordinate. Each layer is best-effort and isolated — one source failing does not fail the others. Demographics (ACS) require a zip; a lat/lon does not resolve to a ZCTA. Public records, not legal or insurance advice.","flood":{"data":{"note":null,"depth":null,"query":{"lat":37.423120361623,"lon":-122.083521249656},"isSFHA":true,"mapped":true,"sources":[{"url":"https://www.fema.gov/flood-maps/national-flood-hazard-layer","license":"Public domain (US government work)","provider":"FEMA National Flood Hazard Layer (NFHL)"}],"floodZone":"A","riskLevel":"high","staticBFE":null,"firmPanelId":"06085C","zoneSubtype":null,"sourceCitation":"06085C_BASE9","zoneDescription":"Special Flood Hazard Area (1% annual-chance / \"100-year\" flood). Flood insurance is mandatory for federally backed mortgages."},"error":null,"found":true},"place":{"data":{"place":"Mountain View city","state":"California","tract":"5046.01","county":"Santa Clara County","stateFips":"06","countyFips":"06085","matchedAddress":"1600 AMPHITHEATRE PKWY, MOUNTAIN VIEW, CA, 94043","congressionalDistrict":"16"},"error":null,"found":true},"query":{"lat":37.423120361623,"lon":-122.083521249656,"zip":"94043","address":"1600 Amphitheatre Parkway, Mountain View, CA"},"climate":{"data":{"nearest":{"id":"US1CASC0014","name":"PALO ALTO 1.7 NE","latitude":37.419,"longitude":-122.1214,"distanceKm":3.4,"elevationM":8.8}},"error":null,"found":true},"seismic":{"data":{"s1":0.6,"ss":1.5,"pga":0.589,"sd1":null,"sdc":null,"sds":1,"siteClass":"D","riskCategory":"II","referenceDocument":"ASCE7-16"},"error":null,"found":true},"sources":[{"url":"https://geocoding.geo.census.gov/","license":"Public domain (US government work)","provider":"US Census Bureau Geocoder"},{"url":"https://www.fema.gov/flood-maps/national-flood-hazard-layer","license":"Public domain (US government work)","provider":"FEMA National Flood Hazard Layer (NFHL)"},{"url":"https://earthquake.usgs.gov/ws/designmaps/","license":"Public domain (US government work)","provider":"USGS Seismic Design Maps (ASCE 7-16)"},{"url":"https://www.ncei.noaa.gov/","license":"Public domain (US government work)","provider":"NOAA NCEI — GHCN climate station network"},{"url":"https://www.census.gov/programs-surveys/acs","license":"Public domain (US government work)","provider":"US Census Bureau — American Community Survey (ACS) 5-year"},{"url":"https://hazards.fema.gov/nri/","license":"Public domain (US government work)","provider":"FEMA National Risk Index (NRI)"}],"summary":{"state":"California","county":"Santa Clara County","isSFHA":true,"floodRisk":"high","riskIndexRating":"Very High","nearestStationKm":3.4,"seismicDesignCategory":null},"riskIndex":{"data":{"note":null,"found":true,"query":{"lat":37.423120361623,"lon":-122.083521249656,"state":null,"county":null,"countyFips":null},"state":"California","county":"Santa Clara","hazards":[{"code":"AVLN","hazard":"Avalanche","riskScore":13.011695906432749,"riskRating":"Very Low","expectedAnnualLossUSD":16.657385240401407},{"code":"CFLD","hazard":"Coastal Flooding","riskScore":88.8,"riskRating":"Relatively High","expectedAnnualLossUSD":6651396.30072},{"code":"CWAV","hazard":"Cold Wave","riskScore":0,"riskRating":"No Rating","expectedAnnualLossUSD":0},{"code":"DRGT","hazard":"Drought","riskScore":99.20483460559797,"riskRating":"Relatively High","expectedAnnualLossUSD":10607698.233440187},{"code":"ERQK","hazard":"Earthquake","riskScore":99.93638676844783,"riskRating":"Very High","expectedAnnualLossUSD":1186762022.0525558},{"code":"HAIL","hazard":"Hail","riskScore":37.531806615776084,"riskRating":"Relatively Low","expectedAnnualLossUSD":197492.8638497172},{"code":"HWAV","hazard":"Heat Wave","riskScore":98.58702633269107,"riskRating":"Relatively High","expectedAnnualLossUSD":23484265.35364488},{"code":"HRCN","hazard":"Hurricane","riskScore":null,"riskRating":"Not Applicable","expectedAnnualLossUSD":null},{"code":"IFLD","hazard":"Riverine Flooding","riskScore":99.77735368956743,"riskRating":"Very High","expectedAnnualLossUSD":720152015.3040962},{"code":"ISTM","hazard":"Ice Storm","riskScore":null,"riskRating":"Not Applicable","expectedAnnualLossUSD":null},{"code":"LNDS","hazard":"Landslide","riskScore":99.74554707379136,"riskRating":"Relatively High","expectedAnnualLossUSD":4922529.708293673},{"code":"LTNG","hazard":"Lightning","riskScore":46.94656488549619,"riskRating":"Relatively Low","expectedAnnualLossUSD":254387.8534521931},{"code":"SWND","hazard":"Strong Wind","riskScore":9.351145038167939,"riskRating":"Very Low","expectedAnnualLossUSD":80798.57660033104},{"code":"TRND","hazard":"Tornado","riskScore":55.78880407124682,"riskRating":"Relatively Low","expectedAnnualLossUSD":1833474.610426832},{"code":"TSUN","hazard":"Tsunami","riskScore":18.461538461538463,"riskRating":"Very Low","expectedAnnualLossUSD":142479.43861899042},{"code":"VLCN","hazard":"Volcanic Activity","riskScore":14.983713355048861,"riskRating":"Very Low","expectedAnnualLossUSD":0.07569982818},{"code":"WFIR","hazard":"Wildfire","riskScore":97.39185750636132,"riskRating":"Relatively Moderate","expectedAnnualLossUSD":10182907.765501028},{"code":"WNTW","hazard":"Winter Weather","riskScore":3.087205601527689,"riskRating":"Very Low","expectedAnnualLossUSD":2443.092870618556}],"sources":[{"url":"https://hazards.fema.gov/nri/","license":"Public domain (US government work)","provider":"FEMA National Risk Index (NRI)"}],"riskIndex":{"score":99.74554707379136,"rating":"Very High","nationalPercentile":99.74554707379136},"countyFips":"06085","population":1934625,"stateAbbrev":"CA","expectedAnnualLoss":{"rating":"Very High","totalUSD":1965273927.8871555,"nationalPercentile":94.82758620689656},"communityResilience":{"score":72.6145038167939,"rating":"Relatively High","nationalPercentile":87.93103448275862},"socialVulnerability":{"score":17.23918575,"rating":"Very Low","nationalPercentile":13.79310345}},"error":null,"found":true},"demographics":{"data":{"zip":"94043","race":{"asian":10895,"black":1296,"other":1487,"white":14018,"twoOrMore":4658,"americanIndianAlaskaNative":206,"nativeHawaiianPacificIslander":110},"income":{"medianHouseholdUSD":174416},"acsYear":2022,"housing":{"units":14751,"occupied":13369,"ownerOccupied":5948,"renterOccupied":7421,"pctOwnerOccupied":44.49,"medianGrossRentUSD":2839,"medianHomeValueUSD":1562200},"poverty":{"universe":32603,"rateBelow":3.86,"countBelow":1259},"education":{"masters":6638,"universe":23996,"bachelors":6824,"doctorate":2392,"highSchool":2054,"professional":844,"pctBachelorsOrHigher":69.59},"ethnicity":{"hispanicOrLatino":6327},"medianAge":35.9,"updatedAt":"2026-05-27T18:53:48.366Z","workforce":{"unemployed":620,"laborForceSize":19771,"unemploymentRate":3.14},"acsRelease":"ACS 5-year 2018-2022","households":{"total":13369,"singlePerson":5604},"population":32670},"error":null,"found":true}},"meta":{"cost":{"usd":0.0072,"tier":0},"caller":"x402","version":null,"endpoint":"geo.location-dossier","settlement":{"txHash":"0xf170c1aa0be720705b22ac766bda9a436cfb6612cf2e54d69d77951423e6fea7","network":"eip155:8453","success":true}}}},"exampleRequest":{"zip":"94043","address":"1600 Amphitheatre Parkway, Mountain View, CA"},"tags":["x402"],"displayCostAmount":"0.0072","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0072/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.018","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.018","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mau83_qdoqusuQEkRERnd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.018","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive geo-risk dossier for a US location including flood zone, seismic category, climate station, place identity, and optional demographics.","exampleAgentPrompt":"Pull the full location dossier for 1600 Amphitheatre Parkway, Mountain View, CA — I need flood zone, seismic design category, nearest climate station, and county info, and include ACS demographics for ZIP 94043.","exampleUseCases":null,"resultDescription":"A JSON object containing: flood zone code, SFHA boolean, and risk level; state and county; seismic design category (e.g. 'D') and spectral acceleration per ASCE7-16; nearest climate station ID and distance in km; optional ACS population; plus a top-level summary object consolidating key fields. Each sub-section includes a found/error flag.","failureModes":["Address cannot be geocoded — place.found=false with error message","Coordinate falls outside US coverage — flood or seismic data not found","Invalid lat/lon format — returns 400 or empty results","ZIP not provided — demographics section omitted (not an error)","FEMA or USGS source temporarily unavailable — individual section found=false with error"],"whenToPreferThis":"Use this endpoint when you need a single-call, multi-source geo-risk snapshot for a US location covering flood, seismic, climate, and place identity together. Prefer over piecing together individual FEMA, USGS, or Census calls when you need a quick aggregated dossier at low cost ($0.0072 USDC). Ideal for real estate underwriting, site selection, AI-driven property analysis, or any workflow needing authoritative US hazard data without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:06:46.797Z","isFirstParty":false}