# HALOWERK Southern Land – Italy Soil Nitrogen (0-5 cm)

> HALOWERK Southern Land – Italy Soil Nitrogen (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 total nitrogen concentration for the 0–5 cm soil layer at a given coordinate within Italy, validated against Natural Earth boundaries.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-soil-nitrogen
- 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-italy-soil-nitrogen-0-5-cm-d66759cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VR18CGZlE8fNqzHL5NX45

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-italy-soil-nitrogen-0-5-cm-d66759cd -d '<json body>'
```

Example prompt: What's the mean total nitrogen in the top 5 cm of soil at latitude 43.7, longitude 11.3 — the location is inside Italy near Florence?

## When to prefer this

Choose this endpoint when you need authoritative SoilGrids-derived topsoil nitrogen data specifically for a point location within Italy, with built-in geofencing so out-of-boundary calls are safely rejected before payment. Prefer it over generic soil APIs when you need a standardized, pay-per-call microservice scoped to Italy with guaranteed coordinate validation.

## Known failure modes

- Coordinate outside Italy boundary — rejected before payment, error indicating point is out of coverage area
- Coordinate within European input range but outside Italy — rejected by Natural Earth boundary check
- Missing or malformed latitude/longitude — validation error returned
- Latitude or longitude outside the published European range (lat 34–72.5, lon -31.5–40.5) — schema validation failure
- Service unavailable or upstream SoilGrids data issue — server error response

## How this service works

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

## Output

A numeric value representing the mean total nitrogen in the 0–5 cm soil layer at the queried Italian coordinate, drawn from SoilGrids data. The response is only returned if the coordinate falls within the validated Natural Earth boundary of Italy; coordinates outside Italy are rejected before any charge is incurred.

## 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-italy-soil-nitrogen-0-5-cm-d66759cd/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)