GET /statistics/composition
Summary: Get an overview of taxonomic composition.
Operation ID: —
Auth: unknown
Operation ID: —
Auth: unknown
Description
Get an overview of taxonomic composition.
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 |
|---|---|---|---|
| Get overall taxonomic composition | curl |
https://api.obis.org/statistics/composition |
|
| Taxonomic composition for a specific species | curl |
https://api.obis.org/statistics/composition?scientificname=Delphinus%20delphis |
|
| Composition filtered by date range and Red List species | curl |
https://api.obis.org/statistics/composition?startdate=2020-01-01&enddate=2023-12-31&redlist=true |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:54:09.580806 | 200 | 152ms | |
| 2026-03-23 10:42:51.624260 | 200 | 1375ms | |
| 2026-03-23 09:06:19.000920 | 200 | 127ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:42:51.624260 | de8337caab1e |
49b73cc758bc |
| 2026-03-23 10:54:09.580806 | 49b73cc758bc |
a021fdad4c49 |