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

ActionWhat it does
Count records by fieldCount 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 depthCount 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 yearCount 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 reportReport 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 datasetGet 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 taxonLook 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 nodeGet 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 recordGet 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 countsCount 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 statisticsCount 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 areasList 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 datasetsList the datasets added to OBIS most recently, latest publication first, optionally only one node's, with everything 'Search datasets' gives.
List newly recorded speciesList 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 nodesList 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 speciesList 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 recordedList 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 datasetsFind 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 institutesList 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 recordsFind 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 byfieldslistRequired
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 fieldvalues_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.
Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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

DatasetdatasettextRequired
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

TaxontaxontextRequired
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

NodenodetextRequired
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 IDrecord_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

Datasetdatasettext
The dataset's OBIS ID or obis.org address. Leave empty to count a node's downloads instead.
Nodenodetext
The OBIS node, when not counting a dataset.
From datestart_datedate
For a dataset: also count the downloads on or after this day.
To dateend_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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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 areaarea_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 containsname_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

Nodenodetext
Only datasets from this OBIS node, among the 200 newest. Leave empty for every node.
Number of datasetslimitnumber
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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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 taxalimitnumber
How many taxa to return, from 1 to 1,000.From 1 to 1000. Default: 100.
Pagepagenumber
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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 flaggedexclude_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 taxalimitnumber
How many taxa to return, from 1 to 1,000.From 1 to 1000. Default: 100.
Pagepagenumber
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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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 taxalimitnumber
How many taxa to return, from 1 to 1,000.From 1 to 1000. Default: 100.
Pagepagenumber
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 wordswordstext
Words in the dataset's title, description or keywords. Leave empty to search by the other fields alone.
Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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 datasetslimitnumber
How many datasets to return, from 1 to 100.From 1 to 100. Default: 20.
Pagepagenumber
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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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 instituteslimitnumber
How many institutes to return, from 1 to 1,000.From 1 to 1000. Default: 100.
Pagepagenumber
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

Taxataxatext
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.
Areasareaslist
Only records in any of these areas: country waters, IHO sea areas, large marine ecosystems, EBSAs, World Heritage sites or the high seas.
Nodesnodeslist
Only records published through any of these OBIS nodes.
Institutesinstituteslist
Only records from any of these institutes.
Datasetsdatasetstext
Only records from these datasets: their IDs or obis.org addresses, separated by commas. 'Search datasets' gives them.
From datestart_datedate
Only records of things seen or sampled on or after this day.
To dateend_datedate
Only records of things seen or sampled on or before this day.
Shallowest depthmin_depthnumber
Only records at this depth or deeper, in metres.From 0 to 11000.
Deepest depthmax_depthnumber
Only records at this depth or shallower, in metres.From 0 to 11000.
Westwestnumber
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.
Southsouthnumber
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.
Easteastnumber
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.
Northnorthnumber
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 onlyred_list_onlytrue/false
Only species on the IUCN Red List of threatened species.Default: false.
Introduced species onlyintroduced_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 onlyharmful_algae_onlytrue/false
Only species on IOC-UNESCO's list of harmful micro algae.Default: false.
Leave out records flaggedexclude_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 recordsabsencetext
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 recordslimitnumber
How many records to return, from 1 to 1,000.From 1 to 1000. Default: 100.
Continue afteraftertext
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
}

On this page