GET /occurrence/grid/{precision}/kml
Summary: Fetch gridded occurrences as KML. Limited to 100,000 features.
Operation ID: —
Auth: unknown
Operation ID: —
Auth: unknown
Description
Fetch gridded occurrences as KML. Limited to 100,000 features.
Parameters (20)
absence
(string, query, optional)
Include absence records (include) or get absence records exclusively (true).
areaid
(string, query, optional)
Area ID.
datasetid
(string, query, optional)
Dataset UUID.
dropped
(string, query, optional)
Include dropped records (include) or get dropped records exclusively (true).
enddate
(string, query, optional)
End date formatted as YYYY-MM-DD.
enddepth
(integer, query, optional)
End depth, in meters.
event
(string, query, optional)
Include pure event records (include) or get pure event records exclusively (true).
exclude
(string, query, optional)
Comma separated list of quality flags to be excluded.
flags
(string, query, optional)
Comma separated list of quality flags which need to be set.
geometry
(string, query, optional)
Geometry, formatted as WKT or GeoHash.
hab
(boolean, query, optional)
HAB species only, true/false.
instituteid
(string, query, optional)
Institute ID.
nodeid
(string, query, optional)
Node UUID.
precision
(integer, path, required)
Grid precision level.
redlist
(boolean, query, optional)
Red List species only, true/false.
scientificname
(string, query, optional)
Scientific name. Leave empty to include all taxa.
startdate
(string, query, optional)
Start date formatted as YYYY-MM-DD.
startdepth
(integer, query, optional)
Start depth, in meters.
taxonid
(string, query, optional)
Taxon AphiaID.
wrims
(boolean, query, optional)
WRiMS species only, true/false.
Examples (3)
| Title | Type | URL | Action |
|---|---|---|---|
| Basic gridded occurrences (precision 5) | curl |
https://api.obis.org/occurrence/grid/5/kml |
|
| Marine mammals in North Atlantic (precision 3) | curl |
https://api.obis.org/occurrence/grid/3/kml?scientificname=Mammalia&geometry=POLYGON%20%28%28-80%2040%2C%20-20%2040%2C%20-20%2070%2C%20-80%2070%2C%20-80%2040%29%29&startdate=2020-01-01&enddate=2023-12-31 |
|
| Blue whale occurrences with quality flags (precision 4) | curl |
https://api.obis.org/occurrence/grid/4/kml?scientificname=Balaenoptera%20musculus&flags=species_identification_status_uncertain,date_time_invalid&startdepth=0&enddepth=500 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 11:02:25.550084 | 200 | 121ms | |
| 2026-03-23 10:51:55.720293 | 200 | 689ms | |
| 2026-03-23 10:48:35.466227 | 200 | 195ms | 2.1MB |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:51:55.720293 | d3c2ecfc557e |
5ec8978aafb1 |
| 2026-03-23 11:02:25.550084 | 5ec8978aafb1 |
b3c40233892a |