# Natur Species Occurrence Lookup

> Natur Species Occurrence Lookup is a paid API for AI agents from natur.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Retrieves georeferenced occurrence records for a species within a radius of a coordinate, annotating each with observation date, coordinate uncertainty, basis of record, publishing dataset, and licence.

## Facts

- Endpoint: POST https://natur.halowerk.com/v1/species-occurrence
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/natur-species-occurrence-lookup-e53dc737
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UmaPg0DvDXwgdA0_9e_-J

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 natur-species-occurrence-lookup-e53dc737 -d '<json body>'
```

Example prompt: Find all occurrence records for Panthera leo within 50 kilometres of coordinates 1.3521° N, 103.8198° E, and tell me the observation date, coordinate uncertainty, basis of record, which dataset published each one, and the licence for each.

## When to prefer this

Use this endpoint when you need georeferenced occurrence records for a specific species centred on a known coordinate, and you require usability metadata (coordinate uncertainty, basis of record, licence) to decide whether individual records are suitable for analysis. Prefer this over generic biodiversity search APIs when you need per-record provenance and data-quality flags rather than just a presence/absence answer.

## Known failure modes

- Unknown or misspelled species name returns empty result set or taxonomic error
- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) return a validation error
- Radius too large or too small may return no records or exceed query limits
- No occurrences exist near the given coordinate for the requested species — empty array returned
- Upstream GBIF data source unavailable — 502 or timeout
- Malformed POST body missing required fields returns 400 error

## How this service works

Retrieves occurrence records for a species within a radius of a coordinate and returns each with what makes it usable or not: the observation date, the coordinate uncertainty in metres, the basis of record — whether it is a preserved specimen, a human observation or a machine detection — the publishing dataset, and the licence of that record.

## Output

A list of occurrence records, each containing: observation date, coordinate uncertainty in metres, basis of record (preserved specimen / human observation / machine detection), the name of the publishing dataset, and the licence under which the record is released — along with any usability flags indicating whether the record meets data-quality criteria.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "limit": {
   "type": "integer",
   "default": 100,
   "maximum": 300,
   "minimum": 1
  },
  "species": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2,
   "description": "Accepted scientific name. Resolve it first if unsure."
  },
  "radius_km": {
   "type": "number",
   "default": 25,
   "maximum": 300,
   "minimum": 1
  },
  "years_back": {
   "type": "integer",
   "default": 25,
   "maximum": 200,
   "minimum": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/natur-species-occurrence-lookup-e53dc737/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from natur.halowerk.com](https://www.zero.xyz/host/natur.halowerk.com/llms.txt)