# 2s Soil Profile Lookup

> 2s Soil Profile Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns USDA-NRCS SSURGO soil profile data (components, drainage, taxonomy, hydrologic group) for a given latitude/longitude coordinate.

## Facts

- Endpoint: GET https://2s.io/api/soil/profile
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-soil-profile-lookup-a84ef8bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PYv_nAFYMdJYs1o0wiqdP

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-soil-profile-lookup-a84ef8bd
```

Example prompt: What's the soil profile at latitude 42, longitude -93.6 — I need the soil components, drainage class, taxonomic order, and hydrologic group for that location.

## When to prefer this

Choose this endpoint when you need ground-truth USDA SSURGO soil classification data for a specific geographic point, especially for agricultural, environmental, construction, or land-use analysis. Ideal when you need soil taxonomy, drainage class, or hydrologic group at a coordinate without managing USDA API keys or authentication.

## Known failure modes

- Coordinates outside the US where SSURGO data is unavailable — returns empty items array
- Invalid lat/lon values outside the valid range (-90 to 90 lat, -180 to 180 lon) — schema validation error
- Coordinates in water bodies or areas with no mapped soil units — returns empty or null result
- Payment failure via x402 if USDC balance is insufficient
- Network timeout from upstream USDA SSURGO web service

## How this service works

Ground-truth soil profile for any US latitude/longitude from the USDA-NRCS SSURGO survey (Soil Data Access). Returns the soil map unit plus its component soil types ranked by composition percent, each with taxonomic order/class, drainage class, hydrologic group, and representative slope. Keyless, public-domain. Use for agronomy, land assessment, hydrology, septic/foundation suitability, and crop-fit reasoning. Coordinates over water or outside surveyed areas return an empty component list.

## Output

Returns an array of map units at the given coordinates, each with soil components listing component name, slope percent, drainage class, taxonomic class and order, hydrologic group, and percent composition — plus the data source attribution from USDA-NRCS SSURGO.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "lat": 42,
   "lon": -93.6
  }
 }
}
```

## 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": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-soil-profile-lookup-a84ef8bd/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)