GET /dataset
Summary: Find dataset records.
Operation ID: —
Auth: unknown
Operation ID: —
Auth: unknown
Description
Find dataset records.
Parameters (17)
absence
(string, query, optional)
Include absence records (include) or get absence records exclusively (true).
areaid
(string, query, optional)
Area ID.
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.
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.
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 |
|---|---|---|---|
| Search datasets by scientific name | curl |
https://api.obis.org/dataset?scientificname=Mola%20mola |
|
| Search datasets by area ID and date range | curl |
https://api.obis.org/dataset?areaid=1&startdate=2023-01-01&enddate=2023-12-31 |
|
| Search datasets by taxon ID and depth range | curl |
https://api.obis.org/dataset?taxonid=127405&startdepth=0&enddepth=100 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:22:11.139078 | 200 | 3141ms | 1.2MB |
| 2026-03-23 10:09:27.489237 | 200 | 955ms | |
| 2026-03-23 09:41:49.748339 | 200 | 797ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:09:27.489237 | b6b85349316a |
a4e8c849f362 |
| 2026-03-23 10:22:11.139078 | a4e8c849f362 |
b53a427b6113 |