GET /occurrence
Summary: Find occurrence records.
Operation ID: —
Auth: unknown
Operation ID: —
Auth: unknown
Description
Find occurrence records.
Parameters (33)
absence
(string, query, optional)
Include absence records (include) or get absence records exclusively (true).
after
(string, query, optional)
Occurrence UUID up to which to skip.
areaid
(string, query, optional)
Area ID.
datasetid
(string, query, optional)
Dataset UUID.
dna
(boolean, query, optional)
Include DNADerivedData records, true/false.
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.
extensions
(string, query, optional)
Extensions to include (e.g. MeasurementOrFact, DNADerivedData).
fields
(string, query, optional)
Fields to be included in the result set.
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.
hasextensions
(string, query, optional)
Extensions that need to be present (e.g. MeasurementOrFact, DNADerivedData).
instituteid
(string, query, optional)
Institute ID.
measurementtype
(string, query, optional)
Measurement type to be present for occurrence.
measurementtypeid
(string, query, optional)
Measurement type ID to be present for occurrence.
measurementunit
(string, query, optional)
Measurement unit to be present for occurrence.
measurementunitid
(string, query, optional)
Measurement unit ID to be present for occurrence.
measurementvalue
(string, query, optional)
Measurement value to be present for occurrence.
measurementvalueid
(string, query, optional)
Measurement value ID to be present for occurrence.
mof
(boolean, query, optional)
Include MeasurementOrFact records, true/false.
nodeid
(string, query, optional)
Node UUID.
qcfields
(boolean, query, optional)
Include lists of missing and invalid fields, true/false.
redlist
(boolean, query, optional)
Red List species only, true/false.
scientificname
(string, query, optional)
Scientific name. Leave empty to include all taxa.
size
(integer, query, optional)
Response size.
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 (5)
| Title | Type | URL | Action |
|---|---|---|---|
| Get biodiversity occurrences | openapi-spec |
https://api.obis.org/v3/occurrence?scientificname=Larus fuscus |
|
| Get occurrence records for species Abra sibogai | sdk_extracted |
https://api.obis.org/occurrence?scientificname=Abra%20sibogai |
|
| Get occurrence records for Anchoa nasus in Peru | sdk_extracted |
https://api.obis.org/occurrence?areaid=190&taxa=Anchoa%20nasus |
|
| Get occurrences in Equatorial Guinea/Gabon polygon | sdk_extracted |
https://api.obis.org/occurrence?geometry=POLYGON%20((9.6034%201.5839,%209.3501%201.1679,%209.1873%201.4555,%209.3027%201.6134,%209.6034%201.5839)) |
|
| Find occurrence records. | probe-gate |
https://api.obis.org/v3/occurrence |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 11:00:21.923193 | 200 | 555ms | |
| 2026-03-23 10:49:36.953024 | 200 | 706ms | |
| 2026-03-23 10:19:59.585366 | 200 | 424ms | |
| 2026-03-23 09:50:27.689557 | 200 | 794ms | |
| 2026-03-23 09:36:36.383316 | 200 | 715ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 09:50:27.689557 | 78fe3a894416 |
7d8e92578f6f |
| 2026-03-23 10:19:59.585366 | 7d8e92578f6f |
6e615ddab609 |
| 2026-03-23 10:49:36.953024 | 6e615ddab609 |
53d3d984ad99 |
| 2026-03-23 11:00:21.923193 | 53d3d984ad99 |
1afe14d32cdb |