Ocean Biodiversity Information System
App · 19 actions
Explore OBIS, UNESCO's open database of 230 million records of where and when marine species were seen or sampled. Search occurrence records by species, sea area, depth, dates or a map box, list the species and the threatened or newly recorded ones in an area, find and read datasets, count records by year, temperature or any field, and run a workflow when new records of a species or a new dataset arrive. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Count records by field | Count the records for any filter by the values of one or more fields, such as species, year, dataset, country, life stage or quality flag, most records first. |
| Count records by temperature, salinity and depth | Count the records for any filter by the sea surface temperature and salinity where they were made and by depth, in bins, to see the conditions a species lives in. |
| Count records by year | Count the records for any filter year by year, oldest first, such as how a species' records have grown, with the busiest year. |
| Get a data quality report | Report on the quality of the records for any filter, such as one dataset's: which Darwin Core fields are missing or invalid in how many records, OBIS's quality flags and how many records each carries, and how many are plotted on land. |
| Get a dataset | Get one OBIS dataset: its title, abstract, citation, DOI, license, nodes, institutes, contacts, record counts, the area it covers, when it was published and last processed, and its downloads by year. |
| Get a taxon | Look up a species or other taxon by scientific name or WoRMS AphiaID: its AphiaID, accepted name, rank, classification, common names, habitats, whether it is introduced or a harmful alga, and how many records OBIS has of it, from which years. |
| Get an OBIS node | Get one OBIS node: what it does, the people who run it, the IPT servers it harvests, its projects, and how many records, species and datasets it has published. |
| Get an occurrence record | Get one occurrence record by its OBIS ID, with everything 'Search occurrence records' gives and every other field it holds (sampling protocol, event IDs, identification remarks...). |
| Get download counts | Count how often a dataset's or a node's records were downloaded from OBIS, by year, and for a dataset between two dates: how many downloads included them and how many records they took. |
| Get record statistics | Count the records for any filter: how many there are, of how many species and taxa, from how many datasets, over which years, and how many are of birds, fish and mammals. |
| List areas | List OBIS's areas, the regions its records can be narrowed to: country waters, IHO sea areas, large marine ecosystems, EBSAs, Marine World Heritage sites and the high seas, with each one's ID. |
| List newest datasets | List the datasets added to OBIS most recently, latest publication first, optionally only one node's, with everything 'Search datasets' gives. |
| List newly recorded species | List the species whose first record, among the records for any filter, is the most recent: species newly found in an area, such as a sea area's new arrivals, with the year each was first recorded. |
| List OBIS nodes | List the 39 OBIS nodes, the regional and thematic networks that publish data to OBIS, with each one's ID, kind, theme, website and location. |
| List Red List species | List the species on the IUCN Red List among the records for any filter, such as the threatened species recorded in an area, most threatened first, with each one's Red List category and record count. |
| List species recorded | List the species and other taxa recorded for any filter, such as every species recorded in a sea area or by a dataset, most records first, with each one's AphiaID, classification, common names and record count. |
| Search datasets | Find OBIS datasets by words in their title and description, and by the records they hold: a taxon, area, node, institute, dates, depth or bounding box. |
| Search institutes | List the institutes behind the records for any filter, such as who records a species or works in a sea area, most records first, with each one's country and OceanExpert ID. |
| Search occurrence records | Find records of where and when marine species were seen or sampled, by taxon, area, node, institute, dataset, dates, depth and a bounding box, optionally only threatened, introduced or harmful species and without flagged records. |
Count records by field
Count the records for any filter by the values of one or more fields, such as species, year, dataset, country, life stage or quality flag, most records first.
Inputs
- Count by
fieldslistRequired - The fields to count by, each counted on its own.One or more of:
species,genus,family,order,class,phylum,kingdom,originalScientificName(Name as recorded),date_year(Year),month(Month, as recorded), and 10 more. - Values per field
values_per_fieldnumber - How many of each field's values to list, most records first, from 1 to 1,000.From 1 to 1000. Default:
20. - Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early).
Outputs
facetslist- One count for each field asked for, in that order.
Example output
{
"facets": [
{
"field": "date_year",
"field_name": "Year",
"values": [
{
"records": 881,
"value": "2020"
},
{
"records": 642,
"value": "2019"
}
]
},
{
"field": "dataset_id",
"field_name": "Dataset",
"values": [
{
"records": 2830,
"value": "eaea291a-1e1d-4382-b86f-ac3cc15b8d5a"
},
{
"records": 2210,
"value": "e054ac7c-f865-4969-a38d-81f732b58565"
}
]
}
]
}Count records by temperature, salinity and depth
Count the records for any filter by the sea surface temperature and salinity where they were made and by depth, in bins, to see the conditions a species lives in.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early).
Outputs
depthlist- Records by depth, in bins of 10 m to 200 m, 100 m to 1,000 m and 1,000 m below, to the deepest that holds a record.
salinitylist- Records by sea surface salinity, in bins of 5.
temperaturelist- Records by sea surface temperature, in bins of 5 °C.
Example output
{
"depth": [
{
"from": 0,
"records": 704,
"to": 10
},
{
"from": 10,
"records": 476,
"to": 20
},
{
"from": 20,
"records": 213,
"to": 30
}
],
"salinity": [
{
"from": 25,
"records": 4,
"to": 30
},
{
"from": 30,
"records": 749,
"to": 35
},
{
"from": 35,
"records": 4823,
"to": 40
}
],
"temperature": [
{
"from": 15,
"records": 316,
"to": 20
},
{
"from": 20,
"records": 3378,
"to": 25
},
{
"from": 25,
"records": 1881,
"to": 30
}
]
}Count records by year
Count the records for any filter year by year, oldest first, such as how a species' records have grown, with the busiest year.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early).
Outputs
busiest_yearnumber- The year with the most records.
countnumber- How many years have records.
total_recordsnumber- How many records those years hold in all.
yearslist- Records by year, oldest first; years with none are left out.
Example output
{
"busiest_year": 2024,
"count": 8,
"total_records": 90,
"years": [
{
"records": 1,
"year": 2019
},
{
"records": 1,
"year": 2020
},
{
"records": 2,
"year": 2021
},
{
"records": 4,
"year": 2022
},
{
"records": 1,
"year": 2023
},
{
"records": 69,
"year": 2024
},
{
"records": 10,
"year": 2025
},
{
"records": 2,
"year": 2026
}
]
}Get a data quality report
Report on the quality of the records for any filter, such as one dataset's: which Darwin Core fields are missing or invalid in how many records, OBIS's quality flags and how many records each carries, and how many are plotted on land.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early).
Outputs
fieldslist- Darwin Core fields that are missing or invalid in some records, the most problems first.
flagslist- OBIS's quality flags on the records, the most common first.
on_landnumber- How many records are plotted on land.
on_land_beyond_buffernumber- How many of those are farther inland than OBIS's coastal buffer.
Example output
{
"fields": [
{
"field": "coordinateUncertaintyInMeters",
"invalid": 2,
"missing": 6383
},
{
"field": "maximumDepthInMeters",
"invalid": 0,
"missing": 4436
},
{
"field": "minimumDepthInMeters",
"invalid": 0,
"missing": 4432
}
],
"flags": [
{
"flag": "NO_DEPTH",
"meaning": "No depth given",
"records": 4418
},
{
"flag": "ON_LAND",
"meaning": "Plotted on land",
"records": 1126
},
{
"flag": "DEPTH_EXCEEDS_BATH",
"meaning": "Deeper than the sea floor there",
"records": 391
}
],
"on_land": 693,
"on_land_beyond_buffer": 7
}Get a dataset
Get one OBIS dataset: its title, abstract, citation, DOI, license, nodes, institutes, contacts, record counts, the area it covers, when it was published and last processed, and its downloads by year.
Inputs
- Dataset
datasettextRequired - The dataset's OBIS ID or obis.org address. 'Search datasets' and 'List newest datasets' give it.
Outputs
absence_recordsnumber- How many of its records are absences.
abstracttext- What it holds, as plain text.
added_attext- When it was first added to OBIS, ISO 8601; empty for old ones.
archive_urltext- Its Darwin Core Archive, to download every record.
citationtext- How to cite it.
contactslist- Its creators, contacts and metadata providers.
coretext- Its Darwin Core core: 'occurrence' or 'event'.
dna_recordsnumber- How many DNA-derived records it has.
doitext- Its DOI or citation link, when it has one.
downloadslist- Downloads of its records, by year.
dropped_recordsnumber- How many records OBIS left out for failing its quality checks.
event_recordsnumber- How many sampling events it has.
extensionslist- Its Darwin Core extensions, such as 'measurementorfact'.
extenttext- The area its records cover, as a WKT polygon.
idtext- The dataset's OBIS ID, which 'Get a dataset' and the filters take.
instituteslist- The institutes behind it.
keywordslist- Its keywords.
licensetext- Its license, as the publisher states it.
measurement_recordsnumber- How many measurements or facts it has.
node_idslist- Those nodes' IDs.
nodeslist- The OBIS nodes that published it.
obis_urltext- Its page on obis.org.
occurrence_recordsnumber- How many occurrence records it has.
processed_attext- When OBIS last processed it, which is when new records reach OBIS.
published_attext- When this version was published, ISO 8601.
recordsnumber- How many of its records match the search; empty outside a search.
source_urltext- Its page on the publisher's IPT server.
tagslist- OBIS's tags on it, such as the environmental DNA tag.
titletext- Its title.
Example output
{
"absence_records": 0,
"abstract": "Original provider:\nHappywhale\nDataset credits:\nHappywhale and contributors\nAbstract:\nHappywhale.com is a resource to help you know whales as individuals, and to benefit conservation science with rich data about individual whales.",
"added_at": "2020-10-12T23:29:59.497Z",
"archive_url": "https://ipt.env.duke.edu/archive.do?r=zd_1718",
"citation": "Happywhale. 2026. Happywhale - Killer whale in North Pacific Ocean. Version 1.5.0. Dataset published in OBIS-SEAMAP and originated from Happywhale.com. https://doi.org/10.82144/1131e581.",
"contacts": [
{
"email": "contact@example.org",
"name": "Dana Rivera",
"organization": "Happywhale.com",
"position": "Primary contact",
"role": "Creator",
"url": "https://happywhale.com"
},
{
"email": "contact@example.org",
"name": "Dana Rivera",
"organization": "Happywhale.com",
"position": "Primary contact",
"role": "Contact",
"url": "https://happywhale.com"
}
],
"core": "occurrence",
"dna_records": 0,
"doi": "https://doi.org/10.82144/1131e581",
"downloads": [
{
"downloads": 839,
"records": 1989736,
"year": 2026
},
{
"downloads": 5125,
"records": 9540780,
"year": 2025
}
],
"dropped_records": 0,
"event_records": 0,
"extensions": [],
"extent": "POLYGON((-176.409867 2.198759,177.718045 2.198759,177.718045 65.787011,-176.409867 65.787011,-176.409867 2.198759))",
"id": "fefcba02-f27c-448e-8038-e4a5e0bd51d7",
"institutes": [
"Duke University"
],
"keywords": [
"Marine Biology",
"PhotoID"
],
"license": "This work is licensed under a Creative Commons Attribution Non Commercial (CC-BY-NC) 4.0 License",
"measurement_records": 0,
"node_ids": [
"573654c1-4ce7-4ea2-b2f1-e4d42f8f9c31"
],
"nodes": [
"OBIS-SEAMAP"
],
"obis_url": "https://obis.org/dataset/fefcba02-f27c-448e-8038-e4a5e0bd51d7",
"occurrence_records": 8374,
"processed_at": "2026-07-15T19:06:35.653Z",
"published_at": "2026-07-15T18:41:01.000Z",
"records": null,
"source_url": "http://ipt.env.duke.edu/resource?r=zd_1718",
"tags": [],
"title": "Happywhale - Killer whale in North Pacific Ocean"
}Get a taxon
Look up a species or other taxon by scientific name or WoRMS AphiaID: its AphiaID, accepted name, rank, classification, common names, habitats, whether it is introduced or a harmful alga, and how many records OBIS has of it, from which years. 'Found' is false when OBIS doesn't know it.
Inputs
- Taxon
taxontextRequired - A scientific name, such as Orcinus orca, or a WoRMS AphiaID. Common names are not searched.
Outputs
accepted_aphia_idnumber- The accepted name's AphiaID.
accepted_nametext- The accepted name, which differs for a synonym.
aphia_idnumber- Its WoRMS AphiaID, such as 137102: what OBIS's other fields take.
authorshiptext- Who named it, and when, such as '(Linnaeus, 1758)'.
classtext- Its class, such as 'Mammalia'.
datasetsnumber- How many datasets hold those records.
familytext- Its family, such as 'Delphinidae'.
first_yearnumber- The year of its earliest record.
foundtrue/false- Whether OBIS knows the taxon. Every other field is empty when not.
genustext- Its genus, such as 'Orcinus'.
harmful_algaetrue/false- Whether it is on IOC-UNESCO's list of harmful micro algae.
introducedtrue/false- Whether it is in the World Register of Introduced Marine Species: introduced somewhere in the world.
is_brackishtrue/false- Whether it lives in brackish water.
is_freshwatertrue/false- Whether it lives in fresh water.
is_marinetrue/false- Whether it lives in the sea; empty when unknown.
is_terrestrialtrue/false- Whether it lives on land.
kingdomtext- Its kingdom, such as 'Animalia'.
last_yearnumber- The year of its latest record.
obis_urltext- Its page on obis.org, with a map of its records.
ordertext- Its order, such as 'Cetartiodactyla'.
phylumtext- Its phylum, such as 'Chordata'.
querytext- The name or AphiaID asked about.
ranktext- Its rank, such as 'Species' or 'Genus'.
recordsnumber- How many occurrence records OBIS has of it.
scientific_nametext- Its scientific name, such as 'Orcinus orca'.
speciestext- Its species, such as 'Orcinus orca'; empty above species level.
statustext- Its status in WoRMS, such as 'accepted'.
vernacular_nameslist- Common names WoRMS lists, such as 'orca'.
worms_urltext- Its page in WoRMS.
Example output
{
"accepted_aphia_id": 137102,
"accepted_name": "Orcinus orca",
"aphia_id": 137102,
"authorship": "(Linnaeus, 1758)",
"class": "Mammalia",
"datasets": 261,
"family": "Delphinidae",
"first_year": 1758,
"found": true,
"genus": "Orcinus",
"harmful_algae": false,
"introduced": false,
"is_brackish": null,
"is_freshwater": null,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"last_year": 2026,
"obis_url": "https://obis.org/taxon/137102",
"order": "Cetartiodactyla",
"phylum": "Chordata",
"query": "Orcinus orca",
"rank": "Species",
"records": 34364,
"scientific_name": "Orcinus orca",
"species": "Orcinus orca",
"status": "accepted",
"vernacular_names": [
"grampus",
"killer-trasher"
],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=137102"
}Get an OBIS node
Get one OBIS node: what it does, the people who run it, the IPT servers it harvests, its projects, and how many records, species and datasets it has published.
Inputs
- Node
nodetextRequired - The OBIS node.
Outputs
activitieslist- Its projects and other activities.
contactslist- The people who run it.
datasetsnumber- How many datasets it has published.
descriptiontext- What it does.
feedslist- The IPT servers it harvests datasets from.
idtext- The node's OBIS ID, which 'Get a node' and the filters take.
latitudenumber- Where it is based: latitude.
longitudenumber- Where it is based: longitude.
nametext- Its name, such as 'OBIS Australia'.
obis_urltext- Its page on obis.org.
recordsnumber- How many occurrence records it has published.
speciesnumber- How many species those records cover.
themetext- What it covers, for a thematic node.
typetext- 'regional', 'thematic' or 'secretariat'.
websitetext- Its own website.
Example output
{
"activities": [],
"contacts": [
{
"email": "node.manager@example.org",
"name": "Sam Okafor"
},
{
"email": "data.manager@example.org",
"name": "Lee Tanaka"
}
],
"datasets": 1298,
"description": "OBIS-SEAMAP, Ocean Biodiversity Information System Spatial Ecological Analysis of Megavertebrate Populations, is a spatially referenced online database, aggregating marine mammal, seabird, sea turtle and ray & shark observation data from across the globe. OBIS-SEAMAP, hosted at Marine Geospatial Ecology Lab, Duke University, is aimed at augmenting our understanding of the distribution and the...",
"feeds": [
{
"active": true,
"url": "https://ipt.env.duke.edu/rss.do",
"website": "https://ipt.env.duke.edu"
}
],
"id": "573654c1-4ce7-4ea2-b2f1-e4d42f8f9c31",
"latitude": 36.0045066,
"longitude": -78.9441046,
"name": "OBIS-SEAMAP",
"obis_url": "https://obis.org/node/573654c1-4ce7-4ea2-b2f1-e4d42f8f9c31",
"records": 5571196,
"species": 520,
"theme": "Marine Megavertebrates OBIS node",
"type": "thematic",
"website": "http://seamap.env.duke.edu"
}Get an occurrence record
Get one occurrence record by its OBIS ID, with everything 'Search occurrence records' gives and every other field it holds (sampling protocol, event IDs, identification remarks...).
Inputs
- Record ID
record_idtextRequired - The record's OBIS ID, as 'Search occurrence records' gives it. OBIS gives a dataset's records new IDs when it processes the dataset again, so use one found recently.
Outputs
all_fieldsobject- Every field OBIS holds for the record, by its Darwin Core name (such as 'samplingProtocol' or 'eventID'), empty ones left out.
aphia_idnumber- The taxon's WoRMS AphiaID, such as 137102.
authorshiptext- Who named the taxon, and when, such as '(Linnaeus, 1758)'.
basis_of_recordtext- What the record is: HumanObservation, MachineObservation, PreservedSpecimen, MaterialSample and so on.
bathymetry_mnumber- Depth of the sea floor there, in metres; negative on land.
catalog_numbertext- Its catalogue number in the collection.
classtext- Its class, such as 'Mammalia'.
collection_codetext- The collection or survey's code.
coordinate_uncertainty_mnumber- How far off the position may be, in metres.
countrytext- The country, as the publisher named it.
dataset_idtext- The OBIS ID of the dataset it comes from.
dataset_nametext- That dataset's name.
dataset_urltext- That dataset's page on obis.org.
depth_mnumber- Depth in metres, as OBIS works it out from the minimum and maximum.
end_datetext- The last day of 'event_date', as YYYY-MM-DD.
event_datetext- When it was seen or sampled, as the publisher wrote it: a date, a date and time, or a range such as '2018-08-27T09:20:00/2018-08-27T09:49:00'.
familytext- Its family, such as 'Delphinidae'.
flagslist- OBIS's quality flags on it, such as ON_LAND or NO_DEPTH; empty when none.
genustext- Its genus, such as 'Orcinus'.
idtext- OBIS's ID for the record. OBIS gives a dataset's records new IDs when it processes the dataset again, so keep 'occurrence_id' to find it later.
individual_counttext- How many individuals were counted, as given.
institution_codetext- The publishing institution's code, such as 'PELAGIS'.
is_absencetrue/false- True when the species was looked for and not found there.
kingdomtext- Its kingdom, such as 'Animalia'.
latitudenumber- Latitude, in decimal degrees.
licensetext- The record's license, such as a Creative Commons link.
life_stagetext- Life stage, such as 'adult' or 'larva', as given.
localitytext- The place, as the publisher described it.
longitudenumber- Longitude, in decimal degrees.
max_depth_mnumber- The deepest depth given, in metres.
min_depth_mnumber- The shallowest depth given, in metres.
modifiedtext- When the publisher last changed the record, as given.
node_idslist- The OBIS nodes that published the dataset.
obis_urltext- The record's page on obis.org.
occurrence_idtext- The publisher's own ID for the record (Darwin Core occurrenceID), which stays the same.
occurrence_statustext- 'present', or 'absent' for an absence record.
ordertext- Its order, such as 'Cetartiodactyla'.
original_nametext- The name as the publisher recorded it.
phylumtext- Its phylum, such as 'Chordata'.
recorded_bytext- Who saw or collected it.
scientific_nametext- The name OBIS matched it to in WoRMS, such as 'Orcinus orca'.
sea_surface_salinitynumber- Sea surface salinity there, from OBIS's climate layers.
sea_surface_temperature_cnumber- Sea surface temperature there, in °C, from OBIS's climate layers.
sextext- Sex, as given.
shore_distance_mnumber- Distance to the coast, in metres; negative on land.
speciestext- Its species, such as 'Orcinus orca'; empty above species level.
start_datetext- The first day of 'event_date', as YYYY-MM-DD.
taxon_ranktext- The rank of the name, such as 'Species'.
vernacular_nametext- A common name the publisher gave, such as 'Killer whale'.
water_bodytext- The sea or ocean, as the publisher named it.
yearnumber- The year it was seen or sampled.
Example output
{
"all_fields": {
"associatedReferences": "Dragi\u010devi\u0107, B., & Ugarkovi\u0107, P. (2025). Invasion underway: exceptional number of records of the devil firefish Pterois miles (Bennett, 1828) in the eastern Adriatic Sea (Croatian coast). Acta Adriatica, 66, 69-81. https://doi.org/10.32582/aa.66.1.7",
"basisOfRecord": "HumanObservation",
"brackish": false,
"class": "Teleostei",
"classid": 293496,
"coordinatePrecision": "0.01",
"country": "Croatia",
"datasetName": "ORMEF_v1.1: Occurrence Records of Mediterranean Exotic Fishes (updated to 01/01/2026)",
"date_end": 1723420800000,
"date_mid": 1723420800000,
"date_start": 1723420800000,
"date_year": 2024,
"decimalLatitude": 43.0783,
"decimalLongitude": 16.1361,
"eventDate": "2024-08-12",
"family": "Scorpaenidae",
"familyid": 125595,
"genus": "Pterois",
"genusid": 204051,
"geodeticDatum": "EPSG:4326",
"gigaclass": "Actinopterygii",
"gigaclassid": 10194,
"individualCount": "1",
"infraphylum": "Gnathostomata",
"infraphylumid": 1828
},
"aphia_id": 218077,
"authorship": null,
"basis_of_record": "HumanObservation",
"bathymetry_m": -15,
"catalog_number": null,
"class": "Teleostei",
"collection_code": null,
"coordinate_uncertainty_m": null,
"country": "Croatia",
"dataset_id": "e054ac7c-f865-4969-a38d-81f732b58565",
"dataset_name": "ORMEF_v1.1: Occurrence Records of Mediterranean Exotic Fishes (updated to 01/01/2026)",
"dataset_url": "https://obis.org/dataset/e054ac7c-f865-4969-a38d-81f732b58565",
"depth_m": null,
"end_date": "2024-08-12",
"event_date": "2024-08-12",
"family": "Scorpaenidae",
"flags": [
"NO_DEPTH"
],
"genus": "Pterois",
"id": "00902fa5-cd6c-4df5-86d2-947e503c4518",
"individual_count": "1",
"institution_code": null,
"is_absence": false,
"kingdom": "Animalia",
"latitude": 43.0783,
"license": null,
"life_stage": null,
"locality": "Oklju\u0107na (Vis)",
"longitude": 16.1361,
"max_depth_m": null,
"min_depth_m": null,
"modified": null,
"node_ids": [
"1ad35eb9-c615-4733-864a-b585aebcfb70"
],
"obis_url": "https://obis.org/occurrence/00902fa5-cd6c-4df5-86d2-947e503c4518",
"occurrence_id": "ORMEF_PTEMIL2024128Croatia14028",
"occurrence_status": "present",
"order": "Perciformes",
"original_name": "Pterois miles",
"phylum": "Chordata",
"recorded_by": null,
"scientific_name": "Pterois miles",
"sea_surface_salinity": 38.25,
"sea_surface_temperature_c": 18.88,
"sex": null,
"shore_distance_m": 33,
"species": "Pterois miles",
"start_date": "2024-08-12",
"taxon_rank": null,
"vernacular_name": null,
"water_body": "Mediterranean Sea",
"year": 2024
}Get download counts
Count how often a dataset's or a node's records were downloaded from OBIS, by year, and for a dataset between two dates: how many downloads included them and how many records they took.
Inputs
- Dataset
datasettext - The dataset's OBIS ID or obis.org address. Leave empty to count a node's downloads instead.
- Node
nodetext - The OBIS node, when not counting a dataset.
- From date
start_datedate - For a dataset: also count the downloads on or after this day.
- To date
end_datedate - For a dataset: also count the downloads on or before this day.
Outputs
dataset_idtext- The dataset counted, when it was a dataset.
node_idtext- The node counted, when it was a node.
range_downloadsnumber- Downloads between 'From date' and 'To date'; empty without them.
range_recordsnumber- Records downloaded between those dates; empty without them.
total_downloadsnumber- Downloads over every year.
total_recordsnumber- Records downloaded over every year.
yearslist- Downloads by year, latest first.
Example output
{
"dataset_id": "fefcba02-f27c-448e-8038-e4a5e0bd51d7",
"node_id": null,
"range_downloads": 47,
"range_records": 213253,
"total_downloads": 18098,
"total_records": 32251453,
"years": [
{
"downloads": 839,
"records": 1989736,
"year": 2026
},
{
"downloads": 5125,
"records": 9540780,
"year": 2025
}
]
}Get record statistics
Count the records for any filter: how many there are, of how many species and taxa, from how many datasets, over which years, and how many are of birds, fish and mammals.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early).
Outputs
birds_recordsnumber- How many are of birds.
birds_speciesnumber- How many bird species.
datasetsnumber- How many datasets they come from.
first_yearnumber- The year of the earliest.
fish_recordsnumber- How many are of fish.
fish_speciesnumber- How many fish species.
last_yearnumber- The year of the latest.
mammals_recordsnumber- How many are of mammals.
mammals_speciesnumber- How many mammal species.
other_recordsnumber- How many are of anything else.
other_speciesnumber- How many other species.
recordsnumber- How many occurrence records match.
speciesnumber- How many species they cover.
species_level_recordsnumber- How many are identified to species or below.
taxanumber- How many taxa of any rank they cover.
Example output
{
"birds_records": 6170,
"birds_species": 89,
"datasets": 197,
"first_year": 1833,
"fish_records": 44805,
"fish_species": 362,
"last_year": 2026,
"mammals_records": 1331,
"mammals_species": 9,
"other_records": 224819,
"other_species": 4673,
"records": 296477,
"species": 5168,
"species_level_records": 172482,
"taxa": 8413
}List areas
List OBIS's areas, the regions its records can be narrowed to: country waters, IHO sea areas, large marine ecosystems, EBSAs, Marine World Heritage sites and the high seas, with each one's ID.
Inputs
- Kinds of area
area_typeslist - Only areas of these kinds. Leave empty for every kind.One or more of:
obis(Country waters),iho(Sea area (IHO)),lme(Large marine ecosystem),ebsa(Ecologically or biologically significant area (EBSA)),mwhs(Marine World Heritage site),abnj(High seas (beyond national jurisdiction)). - Name contains
name_containstext - Only areas whose name contains this text, in any case.
Outputs
areaslist- The areas, by name.
countnumber- How many are in this answer.
Example output
{
"areas": [
{
"id": "33314",
"name": "Adriatic Sea",
"obis_url": "https://obis.org/area/33314",
"type": "iho",
"type_name": "Sea area (IHO)"
},
{
"id": "33315",
"name": "Aegean Sea",
"obis_url": "https://obis.org/area/33315",
"type": "iho",
"type_name": "Sea area (IHO)"
},
{
"id": "33324",
"name": "Alboran Sea",
"obis_url": "https://obis.org/area/33324",
"type": "iho",
"type_name": "Sea area (IHO)"
}
],
"count": 3
}List newest datasets
List the datasets added to OBIS most recently, latest publication first, optionally only one node's, with everything 'Search datasets' gives.
Inputs
- Node
nodetext - Only datasets from this OBIS node, among the 200 newest. Leave empty for every node.
- Number of datasets
limitnumber - How many datasets to return, from 1 to 100.From 1 to 100. Default:
20.
Outputs
countnumber- How many are in this answer.
datasetslist- The datasets added to OBIS most recently, latest publication first.
Example output
{
"count": 2,
"datasets": [
{
"absence_records": 0,
"abstract": "Original provider:\nNOAA Northeast Fisheries Science Center (NEFSC)\nDataset credits:\nWhale Ecology Branch, Northeast Fisheries Science Center, NOAA/NMFS\nAbstract:\nThe North Atlantic Right Whale Sighting Survey (NARWSS) is a NOAA Fisheries program which locates and records the seasonal distribution of right whales off the northeastern United States.",
"added_at": "2026-10-22T15:29:38.874Z",
"archive_url": "https://ipt.env.duke.edu/archive.do?r=zd_102026",
"citation": "Khan, C., T. Cole and A. Ogilvie. 2026. NEFSC Right Whale Aerial Survey in 2026. Version 1.0.0. Dataset published in OBIS-SEAMAP. Data accessed on yyyy-mm-dd from https://seamap.env.duke.edu/dataset/102026.",
"core": "occurrence",
"dna_records": 0,
"doi": "https://seamap.env.duke.edu/dataset/102026",
"dropped_records": 0,
"event_records": 0,
"extensions": [],
"extent": "POLYGON((-73.18693 39.3334,-63.00381 39.3334,-63.00381 48.58346,-73.18693 48.58346,-73.18693 39.3334))",
"id": "d211002e-e2e0-447b-b95c-29eedefaea12",
"institutes": [
"Duke University"
],
"keywords": [
"Occurrence",
"Observation"
],
"license": "To the extent possible under law, the publisher has waived all rights to these data and has dedicated them to the Public Domain (CC0 1.0)",
"measurement_records": 0,
"node_ids": [
"573654c1-4ce7-4ea2-b2f1-e4d42f8f9c31"
],
"nodes": [
"OBIS-SEAMAP"
],
"obis_url": "https://obis.org/dataset/d211002e-e2e0-447b-b95c-29eedefaea12",
"occurrence_records": 399,
"processed_at": "2026-10-22T15:33:25.714Z",
"published_at": "2026-10-22T14:10:13.000Z",
"records": null,
"source_url": "https://ipt.env.duke.edu/resource?r=zd_102026",
"tags": [],
"title": "NEFSC Right Whale Aerial Survey in 2026"
},
{
"absence_records": 0,
"abstract": "Live tracks of seals tagged as part of the Integrated Marine Observation System's Animal Tracking Facility",
"added_at": "2026-10-22T15:29:16.071Z",
"archive_url": "https://members.oceantrack.org/ipt/archive.do?r=otn_imos_rtsat_ct190",
"citation": "IMOS - Animal Tracking Facility - Satellite Relay Tagging Program - Near real-time data with quality-controlled locations\n\nThe citation in a list of references is: \"IMOS. [year-of-data-download], [Title], [data-access-URL], accessed [date-of-access]\".",
"core": "event",
"dna_records": 0,
"doi": null,
"dropped_records": 0,
"event_records": 56601,
"extensions": [
"occurrence"
],
"extent": "POLYGON((34.40981 -68.612515,156.635751 -68.612515,156.635751 -47.159605,34.40981 -47.159605,34.40981 -68.612515))",
"id": "247addc1-acbf-4de6-8263-8d96c4f9671c",
"institutes": [
"University of Tasmania",
"Macquarie University"
],
"keywords": [
"Samplingevent",
"Tags and Tracking Devices"
],
"license": "This work is licensed under a Creative Commons Attribution (CC-BY) 4.0 License",
"measurement_records": 0,
"node_ids": [
"68f83ea7-69a7-44fd-be77-3c3afd6f3cf8"
],
"nodes": [
"OTN-OBIS"
],
"obis_url": "https://obis.org/dataset/247addc1-acbf-4de6-8263-8d96c4f9671c",
"occurrence_records": 32434,
"processed_at": "2026-10-22T15:32:29.134Z",
"published_at": "2026-10-22T13:52:52.000Z",
"records": null,
"source_url": "https://members.oceantrack.org/ipt/resource?r=otn_imos_rtsat_ct190",
"tags": [],
"title": "IMOS Animal Tracking Facility - Near-realtime seal activity in the southern ocean - Campaign: ct190"
}
]
}List newly recorded species
List the species whose first record, among the records for any filter, is the most recent: species newly found in an area, such as a sea area's new arrivals, with the year each was first recorded.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early). - Number of taxa
limitnumber - How many taxa to return, from 1 to 1,000.From 1 to 1000. Default:
100. - Page
pagenumber - Which page to return, from 1. OBIS pages through the first 10,000.From 1 to 10000. Default:
1.
Outputs
countnumber- How many are in this answer.
more_availabletrue/false- Whether there are more after these: raise 'Page' to read them.
pagenumber- Which page this is, from 1.
specieslist- The species, the most recently first recorded first.
Example output
{
"count": 2,
"more_available": true,
"page": 1,
"species": [
{
"accepted_aphia_id": 101016,
"accepted_name": "Corynactis viridis",
"aphia_id": 101016,
"authorship": "Allman, 1846",
"class": "Hexacorallia",
"family": "Corallimorphidae",
"first_year": 2026,
"genus": "Corynactis",
"harmful_algae": false,
"introduced": false,
"is_brackish": null,
"is_freshwater": null,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"obis_url": "https://obis.org/taxon/101016",
"order": "Corallimorpharia",
"phylum": "Cnidaria",
"rank": "Species",
"records": 1,
"scientific_name": "Corynactis viridis",
"species": "Corynactis viridis",
"status": "accepted",
"vernacular_names": [
"green jewel anemone",
"jewel anemone"
],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=101016"
},
{
"accepted_aphia_id": 127391,
"accepted_name": "Syngnathus taenionotus",
"aphia_id": 127391,
"authorship": "Canestrini, 1871",
"class": "Teleostei",
"family": "Syngnathidae",
"first_year": 2026,
"genus": "Syngnathus",
"harmful_algae": false,
"introduced": false,
"is_brackish": true,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"obis_url": "https://obis.org/taxon/127391",
"order": "Syngnathiformes",
"phylum": "Chordata",
"rank": "Species",
"records": 2,
"scientific_name": "Syngnathus taenionotus",
"species": "Syngnathus taenionotus",
"status": "accepted",
"vernacular_names": [],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=127391"
}
]
}List OBIS nodes
List the 39 OBIS nodes, the regional and thematic networks that publish data to OBIS, with each one's ID, kind, theme, website and location.
Inputs
None.
Outputs
countnumber- How many are in this answer.
nodeslist- Every OBIS node, by name.
Example output
{
"count": 3,
"nodes": [
{
"description": null,
"id": "14fc439c-707d-41d6-a3d4-b9d2696205fe",
"latitude": -33.9235315,
"longitude": 18.8490854,
"name": "AfrOBIS",
"obis_url": "https://obis.org/node/14fc439c-707d-41d6-a3d4-b9d2696205fe",
"theme": "Sub-Saharan African OBIS node",
"type": "regional",
"website": "https://obis.org/node/14fc439c-707d-41d6-a3d4-b9d2696205fe"
},
{
"description": "The OBIS node for Antarctica is run by the Royal Belgian Institute of Natural Sciences (RBINS) under the aegis of the Scientific Committee on Antarctic Research (SCAR).",
"id": "dc6c6ea2-83f5-4b18-985a-9efff6320d69",
"latitude": 50.82524,
"longitude": 4.365477,
"name": "Antarctic OBIS",
"obis_url": "https://obis.org/node/dc6c6ea2-83f5-4b18-985a-9efff6320d69",
"theme": null,
"type": "regional",
"website": "http://www.biodiversity.aq/"
},
{
"description": "The Arctic Biodiversity Data Service (ABDS) is the data-management framework for the Conservation of Arctic Flora and Fauna (CAFF), the biodiversity working group of the Arctic Council, and its programs and activities including the Circumpolar Biodiversity Monitoring Programme (CBMP). It is an online, interoperable data management system that serves as a focal point and common platform for all...",
"id": "da50007b-7871-46cf-8530-441b5836d2c1",
"latitude": 65.6847385,
"longitude": -18.1199337,
"name": "Arctic OBIS",
"obis_url": "https://obis.org/node/da50007b-7871-46cf-8530-441b5836d2c1",
"theme": null,
"type": "regional",
"website": "https://www.abds.is/"
}
]
}List Red List species
List the species on the IUCN Red List among the records for any filter, such as the threatened species recorded in an area, most threatened first, with each one's Red List category and record count.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early). - Number of taxa
limitnumber - How many taxa to return, from 1 to 1,000.From 1 to 1000. Default:
100. - Page
pagenumber - Which page to return, from 1. OBIS pages through the first 10,000.From 1 to 10000. Default:
1.
Outputs
countnumber- How many are in this answer.
more_availabletrue/false- Whether there are more after these: raise 'Page' to read them.
pagenumber- Which page this is, from 1.
specieslist- The species on the IUCN Red List, most threatened first.
totalnumber- How many match in all, across every page.
Example output
{
"count": 2,
"more_available": true,
"page": 1,
"species": [
{
"accepted_aphia_id": 105923,
"accepted_name": "Squalus acanthias",
"aphia_id": 105923,
"authorship": "Linnaeus, 1758",
"category": "VU",
"category_name": "Vulnerable",
"class": "Elasmobranchii",
"family": "Squalidae",
"genus": "Squalus",
"harmful_algae": false,
"introduced": false,
"is_brackish": true,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"obis_url": "https://obis.org/taxon/105923",
"order": "Squaliformes",
"phylum": "Chordata",
"rank": "Species",
"records": 920,
"scientific_name": "Squalus acanthias",
"species": "Squalus acanthias",
"status": "accepted",
"vernacular_names": [],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=105923"
},
{
"accepted_aphia_id": 137205,
"accepted_name": "Caretta caretta",
"aphia_id": 137205,
"authorship": "(Linnaeus, 1758)",
"category": "VU",
"category_name": "Vulnerable",
"class": null,
"family": "Cheloniidae",
"genus": "Caretta",
"harmful_algae": false,
"introduced": false,
"is_brackish": null,
"is_freshwater": null,
"is_marine": true,
"is_terrestrial": null,
"kingdom": "Animalia",
"obis_url": "https://obis.org/taxon/137205",
"order": "Testudines",
"phylum": "Chordata",
"rank": "Species",
"records": 512,
"scientific_name": "Caretta caretta",
"species": "Caretta caretta",
"status": "accepted",
"vernacular_names": [],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=137205"
}
],
"total": 68
}List species recorded
List the species and other taxa recorded for any filter, such as every species recorded in a sea area or by a dataset, most records first, with each one's AphiaID, classification, common names and record count.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early). - Number of taxa
limitnumber - How many taxa to return, from 1 to 1,000.From 1 to 1000. Default:
100. - Page
pagenumber - Which page to return, from 1. OBIS pages through the first 10,000.From 1 to 10000. Default:
1.
Outputs
countnumber- How many are in this answer.
more_availabletrue/false- Whether there are more after these: raise 'Page' to read them.
pagenumber- Which page this is, from 1.
taxalist- The taxa, most records first: species and the higher taxa that records were identified only to.
totalnumber- How many match in all, across every page.
Example output
{
"count": 2,
"more_available": true,
"page": 1,
"taxa": [
{
"accepted_aphia_id": 1080,
"accepted_name": "Copepoda",
"aphia_id": 1080,
"authorship": "Milne Edwards, 1840",
"class": "Copepoda",
"family": null,
"genus": null,
"harmful_algae": false,
"introduced": true,
"is_brackish": true,
"is_freshwater": true,
"is_marine": true,
"is_terrestrial": true,
"kingdom": "Animalia",
"obis_url": "https://obis.org/taxon/1080",
"order": null,
"phylum": "Arthropoda",
"rank": "Class",
"records": 2400,
"scientific_name": "Copepoda",
"species": null,
"status": "accepted",
"vernacular_names": [],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=1080"
},
{
"accepted_aphia_id": 5,
"accepted_name": "Protozoa",
"aphia_id": 5,
"authorship": "Owen, 1858",
"class": null,
"family": null,
"genus": null,
"harmful_algae": true,
"introduced": true,
"is_brackish": true,
"is_freshwater": true,
"is_marine": true,
"is_terrestrial": true,
"kingdom": "Protozoa",
"obis_url": "https://obis.org/taxon/5",
"order": null,
"phylum": null,
"rank": "Kingdom",
"records": 2143,
"scientific_name": "Protozoa",
"species": null,
"status": "accepted",
"vernacular_names": [],
"worms_url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=5"
}
],
"total": 8413
}Search datasets
Find OBIS datasets by words in their title and description, and by the records they hold: a taxon, area, node, institute, dates, depth or bounding box. Each comes with its citation, license, nodes, record counts and when OBIS last processed it, most matching records first.
Inputs
- Search words
wordstext - Words in the dataset's title, description or keywords. Leave empty to search by the other fields alone.
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early). - Number of datasets
limitnumber - How many datasets to return, from 1 to 100.From 1 to 100. Default:
20. - Page
pagenumber - Which page to return, from 1. OBIS pages through the first 10,000.From 1 to 10000. Default:
1.
Outputs
countnumber- How many are in this answer.
datasetslist- The datasets, most matching records first.
more_availabletrue/false- Whether there are more after these: raise 'Page' to read them.
pagenumber- Which page this is, from 1.
totalnumber- How many match in all, across every page.
Example output
{
"count": 2,
"datasets": [
{
"absence_records": 0,
"abstract": "Original provider:\nHappywhale\nDataset credits:\nHappywhale and contributors\nAbstract:\nHappywhale.com is a resource to help you know whales as individuals, and to benefit conservation science with rich data about individual whales.",
"added_at": "2020-10-12T23:38:29.526Z",
"archive_url": "https://ipt.env.duke.edu/archive.do?r=zd_1765",
"citation": "Happywhale. 2026. Happywhale - Humpback whale in North Pacific Ocean. Version 1.5.0. Dataset published in OBIS-SEAMAP and originated from Happywhale.com. https://doi.org/10.82144/4991ec34.",
"core": "occurrence",
"dna_records": 0,
"doi": "https://doi.org/10.82144/4991ec34",
"dropped_records": 0,
"event_records": 0,
"extensions": [],
"extent": "POLYGON((-179.911 0.000019,179.791 0.000019,179.791 66.33888,-179.911 66.33888,-179.911 0.000019))",
"id": "fcbb56da-7237-43a3-831e-d45571496c68",
"institutes": [
"Duke University"
],
"keywords": [
"Marine Biology",
"PhotoID"
],
"license": "This work is licensed under a Creative Commons Attribution Non Commercial (CC-BY-NC) 4.0 License",
"measurement_records": 0,
"node_ids": [
"573654c1-4ce7-4ea2-b2f1-e4d42f8f9c31"
],
"nodes": [
"OBIS-SEAMAP"
],
"obis_url": "https://obis.org/dataset/fcbb56da-7237-43a3-831e-d45571496c68",
"occurrence_records": 211278,
"processed_at": "2026-07-15T18:56:46.938Z",
"published_at": "2026-07-15T18:29:56.000Z",
"records": 13243,
"source_url": "http://ipt.env.duke.edu/resource?r=zd_1765",
"tags": [],
"title": "Happywhale - Humpback whale in North Pacific Ocean"
},
{
"absence_records": 0,
"abstract": "Original provider:\nInternational Fund for Animal Welfare, Song of the Whale Team\nDataset credits:\nOliver Boisseau, Marine Conservation Research International",
"added_at": null,
"archive_url": "https://ipt.env.duke.edu/archive.do?r=zd_1158",
"citation": "Boisseau, O. 2025. Visual sightings from Song of the Whale 1993-2013. Version 1.5.0. Dataset published in OBIS-SEAMAP. https://doi.org/10.82144/8fd040c4.",
"core": "occurrence",
"dna_records": 0,
"doi": "https://doi.org/10.82144/8fd040c4",
"dropped_records": 0,
"event_records": 0,
"extensions": [],
"extent": "POLYGON((-74.74535 -36.00085,138.4473 -36.00085,138.4473 68.094,-74.74535 68.094,-74.74535 -36.00085))",
"id": "a4bb1978-5aa4-4fd2-b8f3-ffc19b6467dc",
"institutes": [
"Duke University"
],
"keywords": [
"Occurrence",
"Observation"
],
"license": "This work is licensed under a Creative Commons Attribution Non Commercial (CC-BY-NC) 4.0 License",
"measurement_records": 0,
"node_ids": [
"573654c1-4ce7-4ea2-b2f1-e4d42f8f9c31"
],
"nodes": [
"OBIS-SEAMAP"
],
"obis_url": "https://obis.org/dataset/a4bb1978-5aa4-4fd2-b8f3-ffc19b6467dc",
"occurrence_records": 7022,
"processed_at": "2025-10-13T20:26:54.561Z",
"published_at": "2025-10-09T15:04:40.000Z",
"records": 7022,
"source_url": "http://ipt.env.duke.edu/resource?r=zd_1158",
"tags": [],
"title": "Visual sightings from Song of the Whale 1993-2013"
}
],
"more_available": true,
"page": 1,
"total": 53
}Search institutes
List the institutes behind the records for any filter, such as who records a species or works in a sea area, most records first, with each one's country and OceanExpert ID.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early). - Number of institutes
limitnumber - How many institutes to return, from 1 to 1,000.From 1 to 1000. Default:
100. - Page
pagenumber - Which page to return, from 1. OBIS pages through the first 10,000.From 1 to 10000. Default:
1.
Outputs
countnumber- How many are in this answer.
instituteslist- The institutes, most records first.
more_availabletrue/false- Whether there are more after these: raise 'Page' to read them.
pagenumber- Which page this is, from 1.
totalnumber- How many match in all, across every page.
Example output
{
"count": 2,
"institutes": [
{
"country": null,
"id": null,
"name": "National Institute of Oceanography and Applied Geophysics",
"obis_url": null,
"records": 108258
},
{
"country": "Belgium",
"id": 6223,
"name": "Vlaams Instituut voor de Zee",
"obis_url": "https://obis.org/institute/6223",
"records": 72140
}
],
"more_available": true,
"page": 1,
"total": 231
}Search occurrence records
Find records of where and when marine species were seen or sampled, by taxon, area, node, institute, dataset, dates, depth and a bounding box, optionally only threatened, introduced or harmful species and without flagged records. Each has the species, date, position, depth, sea temperature, who recorded it and its dataset. Up to 1,000 a step.
Inputs
- Taxa
taxatext - Scientific names (a species, genus, family or any rank) or WoRMS AphiaIDs, separated by commas; not a mix of the two. Synonyms and everything below the taxon are included. Leave empty for every taxon.
- Areas
areaslist - Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
- Nodes
nodeslist - Only records published through any of these OBIS nodes.
- Institutes
instituteslist - Only records from any of these institutes.
- Datasets
datasetstext - Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
- From date
start_datedate - Only records of things seen or sampled on or after this day.
- To date
end_datedate - Only records of things seen or sampled on or before this day.
- Shallowest depth
min_depthnumber - Only records at this depth or deeper, in metres.From 0 to 11000.
- Deepest depth
max_depthnumber - Only records at this depth or shallower, in metres.From 0 to 11000.
- West
westnumber - The box's western edge, a longitude from -180 to 180. Fill in all four edges of the bounding box, or none.From -180 to 180.
- South
southnumber - The box's southern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- East
eastnumber - The box's eastern edge, a longitude from -180 to 180; less than West for a box across the 180th meridian. Fill in all four edges of the bounding box, or none.From -180 to 180.
- North
northnumber - The box's northern edge, a latitude from -90 to 90. Fill in all four edges of the bounding box, or none.From -90 to 90.
- IUCN Red List species only
red_list_onlytrue/false - Only species on the IUCN Red List of threatened species.Default:
false. - Introduced species only
introduced_onlytrue/false - Only species in the World Register of Introduced Marine Species: species introduced somewhere in the world, wherever these records are.Default:
false. - Harmful algae only
harmful_algae_onlytrue/false - Only species on IOC-UNESCO's list of harmful micro algae.Default:
false. - Leave out records flagged
exclude_flagslist - Leave out records OBIS's quality checks flagged in any of these ways, such as plotted on land.One or more of:
ON_LAND(Plotted on land),NO_DEPTH(No depth given),DEPTH_EXCEEDS_BATH(Deeper than the sea floor there),MIN_DEPTH_EXCEEDS_MAX(Minimum depth below the maximum),DEPTH_OUT_OF_RANGE(Depth out of range),MARINE_UNSURE(Not certainly a marine species),NO_ACCEPTED_NAME(No accepted name in WoRMS),DATE_IN_FUTURE(Dated in the future),DATE_BEFORE_MIN(Dated implausibly early). - Absence records
absencetext - Records of species looked for and not found are left out unless asked for.One of:
exclude(Only records of species present),include(Records of species present and absent),only(Only records of species looked for and not found). Default:exclude. - Number of records
limitnumber - How many records to return, from 1 to 1,000.From 1 to 1000. Default:
100. - Continue after
aftertext - To read the next records, the 'next_after' value the previous search gave. Leave empty to start at the first.
Outputs
countnumber- How many are in this answer.
more_availabletrue/false- Whether more records match: put 'next_after' in 'Continue after' to read them.
next_aftertext- The value for 'Continue after' that reads the next records; empty on the last page.
recordslist- The occurrence records, in OBIS's order.
totalnumber- How many match in all, across every page.
Example output
{
"count": 2,
"more_available": true,
"next_after": "010bfd03-3c6e-40ee-be52-16bfb31f2d56",
"records": [
{
"aphia_id": 218077,
"authorship": null,
"basis_of_record": "HumanObservation",
"bathymetry_m": -15,
"catalog_number": null,
"class": "Teleostei",
"collection_code": null,
"coordinate_uncertainty_m": null,
"country": "Croatia",
"dataset_id": "e054ac7c-f865-4969-a38d-81f732b58565",
"dataset_name": "ORMEF_v1.1: Occurrence Records of Mediterranean Exotic Fishes (updated to 01/01/2026)",
"dataset_url": "https://obis.org/dataset/e054ac7c-f865-4969-a38d-81f732b58565",
"depth_m": null,
"end_date": "2024-08-12",
"event_date": "2024-08-12",
"family": "Scorpaenidae",
"flags": [
"NO_DEPTH"
],
"genus": "Pterois",
"id": "00902fa5-cd6c-4df5-86d2-947e503c4518",
"individual_count": "1",
"institution_code": null,
"is_absence": false,
"kingdom": "Animalia",
"latitude": 43.0783,
"license": null,
"life_stage": null,
"locality": "Oklju\u0107na (Vis)",
"longitude": 16.1361,
"max_depth_m": null,
"min_depth_m": null,
"modified": null,
"node_ids": [
"1ad35eb9-c615-4733-864a-b585aebcfb70"
],
"obis_url": "https://obis.org/occurrence/00902fa5-cd6c-4df5-86d2-947e503c4518",
"occurrence_id": "ORMEF_PTEMIL2024128Croatia14028",
"occurrence_status": "present",
"order": "Perciformes",
"original_name": "Pterois miles",
"phylum": "Chordata",
"recorded_by": null,
"scientific_name": "Pterois miles",
"sea_surface_salinity": 38.25,
"sea_surface_temperature_c": 18.88,
"sex": null,
"shore_distance_m": 33,
"species": "Pterois miles",
"start_date": "2024-08-12",
"taxon_rank": null,
"vernacular_name": null,
"water_body": "Mediterranean Sea",
"year": 2024
},
{
"aphia_id": 218077,
"authorship": null,
"basis_of_record": "HumanObservation",
"bathymetry_m": -35,
"catalog_number": null,
"class": "Teleostei",
"collection_code": null,
"coordinate_uncertainty_m": null,
"country": "Croatia",
"dataset_id": "e054ac7c-f865-4969-a38d-81f732b58565",
"dataset_name": "ORMEF_v1.1: Occurrence Records of Mediterranean Exotic Fishes (updated to 01/01/2026)",
"dataset_url": "https://obis.org/dataset/e054ac7c-f865-4969-a38d-81f732b58565",
"depth_m": null,
"end_date": "2024-08-12",
"event_date": "2024-08-12",
"family": "Scorpaenidae",
"flags": [
"NO_DEPTH"
],
"genus": "Pterois",
"id": "010bfd03-3c6e-40ee-be52-16bfb31f2d56",
"individual_count": "1",
"institution_code": null,
"is_absence": false,
"kingdom": "Animalia",
"latitude": 42.9208,
"license": null,
"life_stage": null,
"locality": "Ba\u010dva, Kor\u010dula",
"longitude": 17.0453,
"max_depth_m": null,
"min_depth_m": null,
"modified": null,
"node_ids": [
"1ad35eb9-c615-4733-864a-b585aebcfb70"
],
"obis_url": "https://obis.org/occurrence/010bfd03-3c6e-40ee-be52-16bfb31f2d56",
"occurrence_id": "ORMEF_PTEMIL2024128Croatia14037",
"occurrence_status": "present",
"order": "Perciformes",
"original_name": "Pterois miles",
"phylum": "Chordata",
"recorded_by": null,
"scientific_name": "Pterois miles",
"sea_surface_salinity": 38.39,
"sea_surface_temperature_c": 18.91,
"sex": null,
"shore_distance_m": 3,
"species": "Pterois miles",
"start_date": "2024-08-12",
"taxon_rank": null,
"vernacular_name": null,
"water_body": "Mediterranean Sea",
"year": 2024
}
],
"total": 90
}