# HALOWERK Nordic Land – Finland Soil Total Nitrogen (0-5 cm)

> HALOWERK Nordic Land – Finland Soil Total Nitrogen (0-5 cm) is a paid API for AI agents from nordland.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 Finland's boundary.

## Facts

- Endpoint: POST https://nordland.halowerk.com/v1/fi-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-nordic-land-finland-soil-total-nitrogen-0-5-cm-6bed9799
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_90UwME-Y73fKtiYcNKM5s

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-nordic-land-finland-soil-total-nitrogen-0-5-cm-6bed9799 -d '<json body>'
```

Example prompt: What's the mean total nitrogen in the top 0-5 cm of soil at latitude 61.4978, longitude 23.7610 in Finland? I need the SoilGrids value for that point.

## When to prefer this

Choose this endpoint when you specifically need surface-layer (0-5 cm) total nitrogen data for a location inside Finland, sourced from the SoilGrids global dataset. It is ideal for precision agriculture, land suitability assessment, and environmental monitoring workflows targeting Finnish coordinates. Prefer it over generic soil APIs when you need boundary-validated, pay-per-query access without a subscription, or when building pipelines alongside other HALOWERK Nordic Land soil parameters (pH, organic carbon, texture) for the same coordinate.

## Known failure modes

- Coordinate outside Finland boundary — rejected pre-payment with an error indicating the point is not within the Finnish Natural Earth boundary
- Coordinate within European coverage but outside Finland — still rejected as Finland-only validation is applied
- Latitude or longitude outside the published European coverage range — schema validation error
- SoilGrids upstream data unavailable for the requested cell — may return null or an error
- Malformed request body — 400-level error for missing or invalid latitude/longitude fields

## How this service works

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

## Output

A numeric value representing the mean SoilGrids total nitrogen (g/kg or cg/kg depending on SoilGrids convention) for the 0-5 cm topsoil layer at the requested coordinate, confirmed to lie within Finland's Natural Earth boundary. Coordinates outside Finland 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-nordic-land-finland-soil-total-nitrogen-0-5-cm-6bed9799/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nordland.halowerk.com](https://www.zero.xyz/host/nordland.halowerk.com/llms.txt)