GET /statistics/env
Summary: Get number of records per SST, SSS or depth bin.
Operation ID: —
Auth: unknown
Operation ID: —
Auth: unknown
Description
Get number of records per SST, SSS or depth bin.
Parameters (17)
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.
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.
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 |
|---|---|---|---|
| Basic environmental statistics for all records | curl |
https://api.obis.org/statistics/env |
|
| Statistics for a specific species with date range | curl |
https://api.obis.org/statistics/env?scientificname=Mola%20mola&startdate=2020-01-01&enddate=2023-12-31 |
|
| Statistics for Red List species in a geographic area | curl |
https://api.obis.org/statistics/env?redlist=true&geometry=POLYGON%20((-125%2042%2C%20-125%2048%2C%20-122%2048%2C%20-122%2042%2C%20-125%2042))&startdepth=0&enddepth=200 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:21:04.686284 | 200 | 237ms | |
| 2026-03-23 09:27:21.272627 | 200 | 509ms | |
| 2026-03-23 09:22:12.590163 | 200 | 156ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 09:27:21.272627 | 75038ef29c39 |
4811d4818f3b |
| 2026-03-23 10:21:04.686284 | 4811d4818f3b |
eeffe0d4eb0c |