GET /v2.0/data/datasets

neotomadb.org:neotoma-database-api

Summary: Dataset information.
Operation ID:
Auth: unknown
Description

Returns information about Neotoma dataset. <b>Note</b> -- There are few datasets that use all of the example values below. Generally we search using only one or two of these values, but provide them all to support flexible searching.

Parameters (18)

ageof (integer, query, optional)

Dataset age ranges must span this age (in calibrated years before present, with 0 at 1950CE)

Constraints: {'minimum': -100, 'maximum': 23900000}

ageold (integer, query, optional)

Oldest age that intercepts with the dataset (in calibrated years before present, with 0 at 1950CE)

Constraints: {'minimum': -100, 'maximum': 23900000}

ageyoung (integer, query, optional)

Youngest age that intercepts with the dataset (in calibrated years before present, with 0 at 1950CE)

Constraints: {'minimum': -100, 'maximum': 23900000}

altmax (integer, query, optional)

Maximum altitude of the dataset site location (in meters)

Constraints: {'minimum': -500, 'maximum': 8900}

altmin (integer, query, optional)

Minimum altitude of the dataset site location (in meters)

Constraints: {'minimum': -500, 'maximum': 8900}

contactid (integer, query, optional)

Unique contact identifier within the Neotoma Database, alone or comma separated.

Constraints: {'minimum': 1, 'maximum': 21000}

database (string, query, required)

One of the constituent databases within Neotoma

Constraints: {'enum': ['Cooperative Holocene Mapping Project', 'African Pollen Database', 'European Pollen Database', 'Indo-Pacific Pollen Database', 'Latin American Pollen Database', 'North American Pollen Database', 'Pollen Database of Siberia and the Russian Far East', 'Canadian Pollen Database', 'FAUNMAP', 'Neotoma', 'North American Plant Macrofossil Database', 'Academy of Natural Sciences of Drexel University', 'NDSU Insect Database', 'North American Non-Marine Ostracode Database Project (NANODe)', 'MioMap', 'Alaskan Archaeofaunas', 'French Institute of Pondicherry Palynology and Paleoecology Database', 'Japanese Pollen Database', 'Neotoma Midden Database', 'Chinese Pollen Database', 'Holocene Perspective on Peatland Biogeochemistry', 'ANTIGUA', 'Neotoma Testate Amoebae Database', 'Deep-Time Palynology Database', 'Neotoma Biomarker Database', 'Alpine Pollen Database', 'Canadian Museum of Nature-Delorme Ostracoda-Surface Samples', 'Diatom Paleolimnology Data Cooperative (DPDC)', 'Neotoma Ostracode Database', 'Faunal Isotope Database', 'Neotoma Charcoal Data', 'Pollen Monitoring Programme', 'PaleoVertebrates of Latin America', 'St. Croix Watershed Research Station of the Science Museum of Minnesota']}

datasetid (integer, query, optional)

Valid Neotoma dataset identifier (integer), either singly or in a comma separated list.

Constraints: {'minimum': 0}

datasettype (string, query, optional)

Neotoma contains data for a number of dataset types (see /dbtables/datasettypes. This returns a subset of data types.

Constraints: {'enum': ['geochronologic', 'loss-on-ignition', 'pollen', 'plant macrofossil', 'vertebrate fauna', 'macroinvertebrate', 'pollen surface sample', 'insect', 'ostracode', 'water chemistry', 'diatom', 'ostracode surface sample', 'diatom surface sample', 'geochemistry', 'physical sedimentology', 'charcoal', 'testate amoebae', 'X-ray fluorescence (XRF)', 'X-ray diffraction (XRD)', 'energy dispersive X-ray spectroscopy (EDS/EDX)', 'biomarker', 'modern plant biomarker', 'phytolith', 'specimen stable isotope', 'paleomagnetic,biochemistry', 'modern biochemistry', 'organic carbon', 'insect modern', 'chironomid', 'stable isotope', 'testate amoebae surface sample', 'charcoal surface sample', 'cladocera', 'diatom top-bottom', 'microcharcoal', 'macrocharcoal', 'pollen trap', 'dinoflagellates', 'diatom bottom sample', 'Metabarcoding aeDNA']}

doi (string, query, optional)

A valid DOI in the form 10.XXXX/XXXXX (i.e., excluding 'https://doi.org').

Constraints: {'pattern': '^10.\\d{4,9}/[-._;()/:A-Z0-9]+$'}

gpid (integer, query, optional)

Numeric ID for the geopolitical unit from the Neotoma geopoliticalunits table.

Constraints: {'minimum': 1, 'maximum': 11000}

keyword (?, query, optional)

A valid keyword for samples within Neotoma. The list of valid names can be obtained through a call to the dbtables API call.

Constraints: {'enum': ['modern', 'pre-European', 'interglacial', 'bottom', 'beyond radiocarbon', None]}

limit (integer, query, optional, default: 25)

The maximum number of records to be returned, default is 25.

Constraints: {'minimum': 1, 'maximum': 10000}

loc (string, query, optional)

The geographic region of interest for the site, as a GeoJSON string or valid Well Known Text (WKT). Assumed projection of EPSG:4376 unless otherwise defined.

offset (integer, query, optional, default: 0)

The offset for returned records when a limit is present. Default is 0.

Constraints: {'minimum': 0}

siteid (integer, query, optional)

Valid Neotoma site identifier (integer), either singly or in a comma separated list.

Constraints: {'minimum': 1, 'maximum': 50000}

sitename (string, query, optional)

Name of the study site (may use the % wildcard). Note that Neotoma study site names are not unique. For example there are more than 15 sites in Neotoma named *Clear Lake*.

taxa (string, query, optional)

The name of a taxon, or a unique taxon identifier within Neotoma (obtained from a call to tables). May be a comma separated list of taxonomic names or numeric identifiers. As elsewhere, the `%` sign can be used as a wildcard.

Examples (2)

TitleTypeURLAction
Search by geographic bounding box and altitude range curl https://api.neotomadb.org/v2.0/data/datasets?database=NAPD&loc=POLYGON%20%28%28-120%2040%2C%20-100%2040%2C%20-100%2050%2C%20-120%2050%2C%20-120%2040%29%29&altmin=1000&altmax=3000&limit=5
Search by age range and taxon curl https://api.neotomadb.org/v2.0/data/datasets?database=NAPD&ageold=10000&ageyoung=5000&taxa=Pinus&limit=5

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 01:50:52.859099 200 28269ms
2026-03-22 21:33:25.257091 200 640ms