# 2s Location Dossier API

> 2s Location Dossier API is a paid API for AI agents from 2s.io, paid per call via x402, $0.0072/call, status unknown (last checked 2026-09-16).

Returns a comprehensive geo-risk dossier for a US location including flood zone, seismic category, climate station, place identity, and optional demographics.

## Facts

- Endpoint: GET https://2s.io/api/geo/location-dossier
- Price: $0.0072/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-location-dossier-api-4f934479
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OpFIa6ndW7goA3qzFh9lo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-location-dossier-api-4f934479
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "zip": "94043",
   "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-location-dossier-api-4f934479/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)