{"uid":"cap_UmaPg0DvDXwgdA0_9e_-J","slug":"natur-species-occurrence-lookup-e53dc737","name":"Natur Species Occurrence Lookup","description":"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.","url":"https://natur.halowerk.com/v1/species-occurrence","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vb5WjUQI96kl47U4WlryM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Verify species presence for conservation report","prompt":"Pull occurrence records for Quercus robur within 30 kilometres of 51.5074° N, 0.1278° W and show me the observation dates, coordinate uncertainties, and whether each record is a preserved specimen, human observation, or machine detection."},{"title":"Filter usable records for species distribution model","prompt":"Get all occurrence records for Apis mellifera within 100 kilometres of 48.8566° N, 2.3522° E — I need the coordinate uncertainty in metres and the licence for each record so I can decide which ones are good enough to include in my model."},{"title":"Identify publishing datasets for a rare amphibian","prompt":"Find occurrence records for Ambystoma mexicanum within 200 kilometres of 19.4326° N, 99.1332° W and list which datasets published them, the basis of record, and the observation dates."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:07.393Z","isFirstParty":false}