# HALOWERK Eastern Land – Bulgaria Land Cover Class

> HALOWERK Eastern Land – Bulgaria Land Cover Class is a paid API for AI agents from ostland.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns the dominant ESA WorldCover 2021 land cover class for a given coordinate within Bulgaria.

## Facts

- Endpoint: POST https://ostland.halowerk.com/v1/bg-landcover-class
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-eastern-land-bulgaria-land-cover-class-589aecd7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Lt5jah4FVXAOIx_3ffLiE

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-eastern-land-bulgaria-land-cover-class-589aecd7 -d '<json body>'
```

Example prompt: What is the dominant ESA WorldCover 2021 land cover class at latitude 42.698, longitude 23.322 in Bulgaria?

## When to prefer this

Use this endpoint when you need a fast, pay-per-call lookup of the dominant ESA WorldCover 2021 land cover class for a specific point coordinate within Bulgaria. It is ideal for agents enriching location data with land use context, performing environmental or agricultural assessments, or verifying terrain type before further analysis. The Bulgaria-specific boundary validation ensures you only pay for valid in-scope results.

## Known failure modes

- Coordinate outside Bulgaria's Natural Earth boundary — request rejected, no charge
- Latitude or longitude out of the accepted European range (34–72.5°N, -31.5–40.5°E) — schema validation error
- Missing required latitude or longitude parameter — validation error
- Network or server timeout — retry recommended
- Payment failure via x402 protocol — call not processed

## How this service works

Dominant ESA WorldCover 2021 class in the analysis area. The coordinate is validated against the Natural Earth boundary for Bulgaria; results outside it are rejected before payment.

## Output

A single dominant ESA WorldCover 2021 land cover class label (e.g. tree cover, shrubland, grassland, cropland, built-up, bare/sparse vegetation, snow/ice, permanent water bodies, herbaceous wetland, mangroves, or moss/lichen) for the queried coordinate within Bulgaria. Coordinates outside Bulgaria'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-eastern-land-bulgaria-land-cover-class-589aecd7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ostland.halowerk.com](https://www.zero.xyz/host/ostland.halowerk.com/llms.txt)