# HALOWERK Southern Land – Spain Soil Organic Carbon (0-5 cm)

> HALOWERK Southern Land – Spain Soil Organic Carbon (0-5 cm) is a paid API for AI agents from suedland.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Returns the mean SoilGrids soil organic carbon content for the 0–5 cm depth layer at a given WGS84 coordinate within Spain, validated against Natural Earth boundaries.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/es-soil-organic-carbon
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-spain-soil-organic-carbon-0-5-cm-e3b23108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PdGUPhK7Nd7IhaODU8NFW

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 halowerk-southern-land-spain-soil-organic-carbon-0-5-cm-e3b23108 -d '<json body>'
```

Example prompt: What's the mean soil organic carbon in the top 5 centimeters at latitude 37.9 and longitude -4.7 in Spain? I need the SoilGrids figure for that spot.

## When to prefer this

Use this endpoint when you specifically need SoilGrids-derived mean soil organic carbon for the 0–5 cm surface layer at a point location within Spain. It is ideal for agricultural land assessment, environmental monitoring, carbon credit verification, or precision farming workflows targeting Spanish territory. Prefer it over generic soil APIs when you need boundary-validated, Spain-specific SOC data with per-call micropayment pricing.

## Known failure modes

- Coordinate outside Spain's Natural Earth boundary — request rejected with a geographic validation error and no charge
- Latitude or longitude outside the declared European coverage bounds (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Missing required latitude or longitude parameter — 400 bad request
- Payment failure via x402 protocol — transaction not processed, no data returned
- SoilGrids upstream unavailability — service error response

## How this service works

Mean SoilGrids organic carbon for the 0-5 cm layer. The coordinate is validated against the Natural Earth boundary for Spain; results outside it are rejected before payment.

## Output

A numeric mean soil organic carbon value from the SoilGrids dataset for the 0–5 cm depth layer at the specified coordinate, expressed in standard SOC units (typically g/kg or dg/kg). Coordinates outside Spain's Natural Earth boundary are rejected before any charge is applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "number",
   "maximum": 72.5,
   "minimum": 34,
   "description": "WGS84 latitude inside the published European coverage."
  },
  "longitude": {
   "type": "number",
   "maximum": 40.5,
   "minimum": -31.5,
   "description": "WGS84 longitude inside the published European coverage."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-southern-land-spain-soil-organic-carbon-0-5-cm-e3b23108/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suedland.halowerk.com](https://www.zero.xyz/host/suedland.halowerk.com/llms.txt)