Macrostrat

App · 17 actions

Look up the geology of any place with Macrostrat, the open geology database from the University of Wisconsin-Madison: what rock is under a point, with its age, rock types and the map it comes from; geologic map units and maps; stratigraphic columns and their rock units; the fossil collections and measurements matched to them; stratigraphic names; the geologic time scale; and minerals. Every result carries its source citation. No account or API key required.

Actions

ActionWhat it does
Find geologic mapsFind the geologic maps Macrostrat holds for a place, or every map it holds, with each map's title, authors, year, publisher, DOI, scale and citation.
Find stratigraphic columnsFind Macrostrat's stratigraphic columns (the rocks under a region, top to bottom) at a place, or holding rocks of a stratigraphic name, age, rock type, environment or economic use, each with its age range, rock types, unit count and sources.
Find time intervals by ageFind the geologic time intervals at an age (which period was 100 million years ago?) or in a range of ages, on any timescale, or list a whole timescale: eons first, then eras, periods, epochs and ages, each youngest first.
Get a columnGet one stratigraphic column by its ID: where it is, its age range, rock types, environments and sources, and every rock unit in it from the top down.
Get a rock unitGet one rock unit by its ID: its names, column, age and named intervals, thickness, rock types and their shares, environments, economic uses, the units above and below it, where it was when it formed, and its references.
Get a stratigraphic conceptGet a stratigraphic concept, which joins the names used for the same rocks, with its lexicon entry: its age, where the name comes from, the basins and provinces it is found in, usage notes, its names and a link to its source lexicon.
Get a stratigraphic nameGet one stratigraphic name by its ID, with its rank, age, source and every name in its hierarchy: the group it is in, the formations beside it and their members and beds.
Get the geology at a pointFind out what rock is at a place: the map unit of the most detailed geologic map there, with its name, age in millions of years and named intervals, rock types, description, the Macrostrat rock units matched to it, any fault mapped there, the ground's elevation and the map's citation.
List fossil collectionsList the Paleobiology Database fossil collections matched to a rock unit, a column, a stratigraphic name, a time interval or an age, each with its age, how many fossils it holds and a link to it.
List map units at a pointList every geologic map unit at a place, from the most detailed local map to the global one, each with its age, rock types, description, matched Macrostrat units and its map's citation.
List measurementsList the measurements made on samples of a rock unit or column, or every measurement of one kind: element concentrations, isotopes, radiometric ages and paleocurrent directions, each with its values, sample and source.
Look up a mineralLook up minerals by name, or the start of one, or by group, such as feldspar: each with its chemical formula, hardness, crystal system, colors, lustre and its mindat.org page.
Look up a time intervalLook up a geologic time interval, such as the Permian or the Tremadocian: when it began and ended in millions of years, how long it lasted, its kind, its color on time scale charts, the eon, era, period and epoch it is part of, and its timescales.
Search geologic map unitsFind the units of geologic maps anywhere in the world by words in their descriptions, such as banded iron, or list one map's legend, with each unit's age, rock types, description and map citation, the largest first.
Search rock unitsFind rock units (formations, members and beds in Macrostrat's columns) by stratigraphic name, age, rock type, environment, economic use, place or column, each with its age and named intervals, thickness, rock types and their shares, environments and the references it is compiled from.
Search stratigraphic namesFind stratigraphic names (supergroups, groups, formations, members and beds) that start with, contain or are exactly a name, by rank and age, each with its place in its hierarchy, age range, how many rock units carry it and its source.
Search the dictionaryFind anything in Macrostrat's dictionary whose name starts with some text: time intervals, stratigraphic names, columns, rock types, environments, economic uses, minerals and more, each with its ID for the action that reads it.

Find geologic maps

Find the geologic maps Macrostrat holds for a place, or every map it holds, with each map's title, authors, year, publisher, DOI, scale and citation.

Inputs

Latitudelatitudenumber
To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'.From -90 to 90.
Longitudelongitudenumber
To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'.From -180 to 180.
Map scalesscaleslist
Only maps of these scales, from local maps (the most detailed) to global ones. Leave empty for every scale.One or more of: large (Local (most detailed)), medium (Regional), small (Continental), tiny (Global).
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
mapslist
The maps, the most detailed first.
more_availabletrue/false
True when there is a next page.
pagenumber
Which page this is, from 1.
totalnumber
How many matched.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 4,
  "maps": [
    {
      "area_km2": 3207.0,
      "authors": "Brown, B.A., Peters, R.M., Massie-Ferch, K.",
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. (2013). Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report. https://wgnhs.uwex.edu/pubs/wofr201301di/",
      "doi": null,
      "features": 700,
      "macrostrat_url": "https://macrostrat.org/maps/6",
      "name": "Dane County, WI",
      "publisher": "Open-File Report",
      "scale": "large",
      "source_id": 6,
      "title": "Preliminary Bedrock Geology of Dane County, Wisconsin",
      "url": "https://wgnhs.uwex.edu/pubs/wofr201301di/",
      "year": "2013"
    },
    {
      "area_km2": 8482278.0,
      "authors": "Horton, J.D., C.A. San Juan, and D.B. Stoeser",
      "citation": "Horton, J.D., C.A. San Juan, and D.B. Stoeser (2017). The State Geologic Map Compilation (SGMC) geodatabase of the conterminous United States. U.S. Geological Survey Data Series 1052. https://doi.org/10.3133/ds1052",
      "doi": "10.3133/ds1052",
      "features": 312304,
      "macrostrat_url": "https://macrostrat.org/maps/133",
      "name": "State Geologic Map Compilation",
      "publisher": "U.S. Geological Survey Data Series 1052",
      "scale": "medium",
      "source_id": 133,
      "title": "The State Geologic Map Compilation (SGMC) geodatabase of the conterminous United States",
      "url": "https://pubs.er.usgs.gov/publication/ds1052",
      "year": "2017"
    },
    {
      "area_km2": 66656189.0,
      "authors": "Garrity, C.P., and Soller, D.R.,",
      "citation": "Garrity, C.P., and Soller, D.R. (2009). Database of the Geologic Map of North America: adapted from the map by J.C. Reed, Jr. and others (2005). U.S. Geological Survey Data Series 424. http://pubs.usgs.gov/ds/424/",
      "doi": null,
      "features": 39394,
      "macrostrat_url": "https://macrostrat.org/maps/7",
      "name": "GMNA",
      "publisher": "U.S. Geological Survey Data Series 424",
      "scale": "small",
      "source_id": 7,
      "title": "Database of the Geologic Map of North America: adapted from the map by J.C. Reed, Jr. and others (2005)",
      "url": "http://pubs.usgs.gov/ds/424/",
      "year": "2009"
    },
    {
      "area_km2": 145535839.0,
      "authors": "Chorlton, L.B.",
      "citation": "Chorlton, L.B. (2007). Generalized geology of the world: bedrock domains and major faults in GIS format: a small-scale world geology map with an extended geological attribute database. Geological Survey of Canada, Open...",
      "doi": "10.4095/223767",
      "features": 9143,
      "macrostrat_url": "https://macrostrat.org/maps/154",
      "name": "Generalized Geology of the World",
      "publisher": "Geological Survey of Canada, Open File 5529",
      "scale": "tiny",
      "source_id": 154,
      "title": "Generalized geology of the world: bedrock domains and major faults in GIS format: a small-scale world geology map with an extended geological attribute database",
      "url": "https://geoscan.nrcan.gc.ca/starweb/geoscan/servlet.starweb?path=geoscan/fulle.web&search1=R=223767",
      "year": "2007"
    }
  ],
  "more_available": false,
  "page": 1,
  "total": 4
}

Find stratigraphic columns

Find Macrostrat's stratigraphic columns (the rocks under a region, top to bottom) at a place, or holding rocks of a stratigraphic name, age, rock type, environment or economic use, each with its age range, rock types, unit count and sources.

Inputs

Latitudelatitudenumber
To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'.From -90 to 90.
Longitudelongitudenumber
To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'.From -180 to 180.
Include neighbouring columnsinclude_adjacenttrue/false
Also include the columns that touch the one at the place (or the 'Column' given), for a wider look at the region.Default: false.
Stratigraphic namestrat_nametext
A formation, group or member name, such as Mancos or Green River. Macrostrat matches it loosely, so 'Mancos' finds the Mancos Shale and its members.
Time intervalintervaltext
Only those of this geologic time interval, such as the Permian or the Tremadocian. Pick one from the international time scale, or type any other interval's name or ID.
Age (Ma)age_manumber
Only rocks of this age, in millions of years ago (Ma), such as 271. Use this or an age range, not both.From 0 to 4600.0.
Youngest age (Ma)youngest_age_manumber
With 'Oldest age (Ma)', only rocks that formed at some time between the two ages. Ages count back from today, so this is the smaller number. Leave it empty for up to today.From 0 to 4600.0.
Oldest age (Ma)oldest_age_manumber
The older end of the age range, in millions of years ago, such as 260. Leave it empty for back to the Earth's beginning.From 0 to 4600.0.
Rock typelithologytext
Only these rocks: a whole class (all igneous rocks), a type (all carbonate rocks) or one lithology, such as sandstone. A lithology's name can be typed too.
Environmentenvironmenttext
Only rocks that formed in this environment: a class (marine or non-marine), a type (such as fluvial) or one environment, such as deltaic. An environment's name can be typed too.
Economic useeconomic_usetext
Only rocks with this economic use or resource: a class (energy, material, precious commodity or water), a type (such as hydrocarbon) or one use, such as coal or aquifer.
Projectprojecttext
Only columns of this Macrostrat project: a region such as North America or New Zealand, or the offshore drilling sites.
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
columnslist
The columns, as Macrostrat lists them.
countnumber
How many are in this answer.
more_availabletrue/false
True when there is a next page.
pagenumber
Which page this is, from 1.
totalnumber
How many matched.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "columns": [
    {
      "age": "Statherian to Chazyan, 1760 to 458.2 Ma",
      "area_km2": 18140.9,
      "column_id": 187,
      "column_type": "column",
      "column_url": "https://macrostrat.org/columns/187",
      "economic_uses": [],
      "environments": [
        {
          "class": "marine",
          "environ_id": 93,
          "name": "inferred marine",
          "proportion": 0.6154,
          "type": null
        },
        {
          "class": "marine",
          "environ_id": 38,
          "name": "marine",
          "proportion": 0.3846,
          "type": null
        }
      ],
      "fossil_collections": 5,
      "group": "Northern Mid-Continent",
      "group_id": 12,
      "latitude": 43.233,
      "lithologies": [
        {
          "attributes": [],
          "class": "sedimentary",
          "lith_id": 169,
          "name": "quartz arenite",
          "proportion": 0.3497,
          "type": "siliciclastic"
        },
        {
          "attributes": [],
          "class": "sedimentary",
          "lith_id": 31,
          "name": "dolomite",
          "proportion": 0.1778,
          "type": "carbonate"
        },
        {
          "attributes": [],
          "class": "metamorphic",
          "lith_id": 82,
          "name": "slate",
          "proportion": 0.1222,
          "type": "metasedimentary"
        },
        {
          "attributes": [],
          "class": "metamorphic",
          "lith_id": 85,
          "name": "quartzite",
          "proportion": 0.097,
          "type": "metasedimentary"
        }
      ],
      "lithology": "quartz arenite 35%, dolomite 18%, slate 12%, quartzite 10%, siltstone 8%, sandstone 6%, granite 3%, rhyolite 3%, shale 2%, conglomerate 1%, chert 1%, phyllite 1%",
      "longitude": -89.756,
      "max_thickness_m": 2026.0,
      "name": "Baraboo District, Sauk County, Wisconsin",
      "oldest_age_ma": 1760.0,
      "oldest_interval": "Statherian",
      "project": "North America",
      "project_id": 1,
      "references": [
        {
          "citation": "Childs, O.E., 1985, Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180.",
          "doi": null,
          "ref_id": 1,
          "url": null
        }
      ],
      "section_count": 5,
      "status": "active",
      "unit_count": 15,
      "youngest_age_ma": 458.2,
      "youngest_interval": "Chazyan"
    }
  ],
  "count": 1,
  "more_available": false,
  "page": 1,
  "total": 1
}

Find time intervals by age

Find the geologic time intervals at an age (which period was 100 million years ago?) or in a range of ages, on any timescale, or list a whole timescale: eons first, then eras, periods, epochs and ages, each youngest first.

Inputs

Age (Ma)age_manumber
The intervals at this age, in millions of years ago, such as 100. Use this or an age range, not both.From 0 to 4600.0.
Youngest age (Ma)youngest_age_manumber
The younger end of an age range, in millions of years ago. Leave it empty for up to today.From 0 to 4600.0.
Oldest age (Ma)oldest_age_manumber
The older end of an age range, in millions of years ago. Leave it empty for back to the Earth's beginning.From 0 to 4600.0.
Matchmatchtext
With an age range: intervals that overlap any part of it, lie wholly inside it, or span exactly it.One of: overlaps (Any part of the range), within (Wholly inside the range), exact (Exactly the range). Default: overlaps.
Timescaletimescaletext
Only intervals of this timescale, such as the international periods or the North American land mammal ages. On its own, lists the whole timescale.
Limitlimitnumber
How many to return, from 1 to 500.From 1 to 500. Default: 100.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
intervalslist
The intervals, broadest kind first (eons, eras, periods, epochs, ages), each kind youngest first.
more_availabletrue/false
True when more matched than the limit.
totalnumber
How many intervals matched.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 4,
  "intervals": [
    {
      "abbreviation": null,
      "color": "#FFFFFF",
      "duration_myr": 4031.0,
      "int_id": 499,
      "macrostrat_url": "https://macrostrat.org/lex/intervals/499",
      "name": "Precambrian-Phanerozoic",
      "oldest_age_ma": 4031.0,
      "timescales": [],
      "type": "supereon",
      "youngest_age_ma": 0.0
    },
    {
      "abbreviation": "Phnz",
      "color": "#9AD9DD",
      "duration_myr": 538.8,
      "int_id": 275,
      "macrostrat_url": "https://macrostrat.org/lex/intervals/275",
      "name": "Phanerozoic",
      "oldest_age_ma": 538.8,
      "timescales": [
        {
          "name": "international intervals",
          "timescale_id": 11
        },
        {
          "name": "international eons",
          "timescale_id": 14
        }
      ],
      "type": "eon",
      "youngest_age_ma": 0.0
    },
    {
      "abbreviation": "Mz",
      "color": "#67C5CA",
      "duration_myr": 185.902,
      "int_id": 32,
      "macrostrat_url": "https://macrostrat.org/lex/intervals/32",
      "name": "Mesozoic",
      "oldest_age_ma": 251.902,
      "timescales": [
        {
          "name": "international intervals",
          "timescale_id": 11
        },
        {
          "name": "international eras",
          "timescale_id": 13
        }
      ],
      "type": "era",
      "youngest_age_ma": 66.0
    },
    {
      "abbreviation": "Amz",
      "color": "#BD1A8D",
      "duration_myr": 2600.0,
      "int_id": 1573,
      "macrostrat_url": "https://macrostrat.org/lex/intervals/1573",
      "name": "Amazonian",
      "oldest_age_ma": 2600.0,
      "timescales": [
        {
          "name": "Martian Periods",
          "timescale_id": 27
        }
      ],
      "type": "period",
      "youngest_age_ma": 0.0
    }
  ],
  "more_available": true,
  "total": 17
}

Get a column

Get one stratigraphic column by its ID: where it is, its age range, rock types, environments and sources, and every rock unit in it from the top down. 'Found' is false when Macrostrat has no such column.

Inputs

ColumncolumntextRequired
The column's ID, which 'Find stratigraphic columns' and every rock unit give.

Outputs

agetext
The age as words and numbers, oldest first, such as 'Paibian to Tremadocian, 497 to 477.1 Ma' (Ma: millions of years ago).
area_km2number
The area the column stands for, in square kilometres.
attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
column_idnumber
The column's ID. 'Get a column' and the 'Column' fields take it.
column_typetext
'column' for a region, 'section' for one measured section.
column_urltext
The column's page on Macrostrat.
economic_useslist
What the rock is used for or holds, such as an aquifer, coal or oil.
environmentslist
The environments the rock formed in, the largest share first.
fossil_collectionsnumber
How many Paleobiology Database fossil collections come from it.
foundtrue/false
False when Macrostrat has no column with this ID.
grouptext
The group of columns it belongs to, often a geologic province.
group_idnumber
That group's ID.
latitudenumber
The latitude of the column's centre.
lithologieslist
Each rock type in it, the largest share first.
lithologytext
Its rock types as text, with their shares, such as 'dolomite 83%, quartz arenite 17%'.
longitudenumber
The longitude of the column's centre.
max_thickness_mnumber
The greatest thickness of its rocks, in metres.
nametext
The column's name, such as 'Baraboo District, Sauk County, Wisconsin'.
oldest_age_manumber
When it begins: its oldest age, in millions of years ago (Ma).
oldest_intervaltext
The time interval its oldest age falls in, such as 'Paibian'.
projecttext
That project's name.
project_idnumber
The project it belongs to, such as 1 (North America).
referenceslist
The publications the column is compiled from.
section_countnumber
How many sections (gap-bound packages) it has.
statustext
'active', 'in process' or 'obsolete'.
unit_countnumber
How many rock units it has.
unitslist
Its rock units, from the top (youngest) down.
youngest_age_manumber
When it ends: its youngest age, in millions of years ago (Ma).
youngest_intervaltext
The time interval its youngest age falls in, such as 'Tremadocian'.
Example output
{
  "age": "Statherian to Chazyan, 1760 to 458.2 Ma",
  "area_km2": 18140.9,
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "column_id": 187,
  "column_type": "column",
  "column_url": "https://macrostrat.org/columns/187",
  "economic_uses": [],
  "environments": [
    {
      "class": "marine",
      "environ_id": 93,
      "name": "inferred marine",
      "proportion": 0.6154,
      "type": null
    },
    {
      "class": "marine",
      "environ_id": 38,
      "name": "marine",
      "proportion": 0.3846,
      "type": null
    }
  ],
  "fossil_collections": 5,
  "found": true,
  "group": "Northern Mid-Continent",
  "group_id": 12,
  "latitude": 43.233,
  "lithologies": [
    {
      "attributes": [],
      "class": "sedimentary",
      "lith_id": 169,
      "name": "quartz arenite",
      "proportion": 0.3497,
      "type": "siliciclastic"
    },
    {
      "attributes": [],
      "class": "sedimentary",
      "lith_id": 31,
      "name": "dolomite",
      "proportion": 0.1778,
      "type": "carbonate"
    },
    {
      "attributes": [],
      "class": "metamorphic",
      "lith_id": 82,
      "name": "slate",
      "proportion": 0.1222,
      "type": "metasedimentary"
    },
    {
      "attributes": [],
      "class": "metamorphic",
      "lith_id": 85,
      "name": "quartzite",
      "proportion": 0.097,
      "type": "metasedimentary"
    }
  ],
  "lithology": "quartz arenite 35%, dolomite 18%, slate 12%, quartzite 10%, siltstone 8%, sandstone 6%, granite 3%, rhyolite 3%, shale 2%, conglomerate 1%, chert 1%, phyllite 1%",
  "longitude": -89.756,
  "max_thickness_m": 2026.0,
  "name": "Baraboo District, Sauk County, Wisconsin",
  "oldest_age_ma": 1760.0,
  "oldest_interval": "Statherian",
  "project": "North America",
  "project_id": 1,
  "references": [
    {
      "citation": "Childs, O.E., 1985, Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180.",
      "doi": null,
      "ref_id": 1,
      "url": null
    }
  ],
  "section_count": 5,
  "status": "active",
  "unit_count": 15,
  "units": [
    {
      "age": "Chazyan, 459.186 to 458.2 Ma",
      "color": "#FCF768",
      "environment": "inferred marine",
      "fossil_collections": 0,
      "lithology": "quartz arenite 100%",
      "max_thickness_m": 35.0,
      "min_thickness_m": 0.0,
      "name": "St Peter Fm",
      "oldest_age_ma": 459.186,
      "oldest_interval": "Chazyan",
      "section_id": 1461,
      "strat_name": "St Peter Sandstone",
      "unit_id": 6122,
      "youngest_age_ma": 458.2,
      "youngest_interval": "Chazyan"
    },
    {
      "age": "Tremadocian, 486.85 to 477.1 Ma",
      "color": "#4D52E7",
      "environment": "inferred marine",
      "fossil_collections": 3,
      "lithology": "dolomite 83%, quartz arenite 17%",
      "max_thickness_m": 30.0,
      "min_thickness_m": 0.0,
      "name": "Oneonta Fm",
      "oldest_age_ma": 486.85,
      "oldest_interval": "Tremadocian",
      "section_id": 1463,
      "strat_name": "Oneota Formation",
      "unit_id": 6124,
      "youngest_age_ma": 477.1,
      "youngest_interval": "Tremadocian"
    },
    {
      "age": "Trempealeauan to Cambrian, 488.2625 to 486.85 Ma",
      "color": "#FCF768",
      "environment": "marine",
      "fossil_collections": 0,
      "lithology": "quartz arenite 100%",
      "max_thickness_m": 15.0,
      "min_thickness_m": 0.0,
      "name": "Jordan Fm",
      "oldest_age_ma": 488.2625,
      "oldest_interval": "Trempealeauan",
      "section_id": 1463,
      "strat_name": "Jordan Formation",
      "unit_id": 6125,
      "youngest_age_ma": 486.85,
      "youngest_interval": "Cambrian"
    },
    {
      "age": "Trempealeauan, 492.5 to 488.2625 Ma",
      "color": "#4D52E7",
      "environment": "inferred marine",
      "fossil_collections": 0,
      "lithology": "dolomite 83%, siltstone 17%",
      "max_thickness_m": 10.0,
      "min_thickness_m": 0.0,
      "name": "St Lawrence Fm",
      "oldest_age_ma": 492.5,
      "oldest_interval": "Trempealeauan",
      "section_id": 1463,
      "strat_name": "St Lawrence Dolomite",
      "unit_id": 6126,
      "youngest_age_ma": 488.2625,
      "youngest_interval": "Trempealeauan"
    }
  ],
  "youngest_age_ma": 458.2,
  "youngest_interval": "Chazyan"
}

Get a rock unit

Get one rock unit by its ID: its names, column, age and named intervals, thickness, rock types and their shares, environments, economic uses, the units above and below it, where it was when it formed, and its references. 'Found' is false when Macrostrat has no such unit.

Inputs

Rock unitunittextRequired
The rock unit's ID, which 'Search rock units', 'Get a column' and the point and map unit actions give.

Outputs

agetext
The age as words and numbers, oldest first, such as 'Paibian to Tremadocian, 497 to 477.1 Ma' (Ma: millions of years ago).
attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
citationslist
Those references as citation lines.
colortext
The color Macrostrat draws it in, as a hex code.
column_idnumber
The column it is in. 'Get a column' takes it.
column_urltext
Its column's page on Macrostrat.
economic_useslist
What the rock is used for or holds, such as an aquifer, coal or oil.
environmentslist
The environments the rock formed in, the largest share first.
formationtext
The formation it is, or is in.
fossil_collectionsnumber
How many Paleobiology Database fossil collections come from it.
fossil_occurrencesnumber
How many fossil occurrences those hold.
foundtrue/false
False when Macrostrat has no rock unit with this ID.
grouptext
The group it is in.
latitudenumber
The latitude of its column's centre.
lithologieslist
Each rock type in it, the largest share first.
lithologytext
Its rock types as text, with their shares, such as 'dolomite 83%, quartz arenite 17%'.
longitudenumber
The longitude of its column's centre.
max_thickness_mnumber
Its greatest thickness, in metres.
measurement_typeslist
The kinds of measurement held for it, such as 'geochemical minor elements'. 'List measurements' lists them.
membertext
The member it is, or is in.
min_thickness_mnumber
Its least thickness, in metres (0 can mean not known).
nametext
The unit's name, such as 'Mancos Shale Fm'.
notestext
Macrostrat's notes on the unit.
oldest_age_manumber
When it begins: its oldest age, in millions of years ago (Ma).
oldest_intervaltext
The time interval its oldest age falls in, such as 'Paibian'.
outcroptext
Where it is found: 'outcrop', 'subsurface' or 'both'.
paleo_latitude_bottomnumber
Where its column was when the unit's bottom formed: the latitude then.
paleo_latitude_topnumber
Where its column was when the unit's top formed: the latitude then.
paleo_longitude_bottomnumber
The longitude then.
paleo_longitude_topnumber
The longitude then.
project_idnumber
The project its column belongs to.
reference_idslist
The references the unit is compiled from.
section_idnumber
The section (package) of the column it is in.
strat_nametext
Its full stratigraphic name, such as 'Mancos Shale'.
strat_name_idnumber
Its stratigraphic name's ID. 'Get a stratigraphic name' takes it.
supergrouptext
The supergroup it is in.
unit_idnumber
The rock unit's ID. 'Get a rock unit' takes it.
units_abovelist
The units resting on top of it.
units_belowlist
The units under it.
youngest_age_manumber
When it ends: its youngest age, in millions of years ago (Ma).
youngest_intervaltext
The time interval its youngest age falls in, such as 'Tremadocian'.
Example output
{
  "age": "Tremadocian, 486.85 to 477.1 Ma",
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "citations": [
    "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985."
  ],
  "color": "#4D52E7",
  "column_id": 187,
  "column_url": "https://macrostrat.org/columns/187",
  "economic_uses": [],
  "environments": [
    {
      "class": "marine",
      "environ_id": 93,
      "name": "inferred marine",
      "proportion": null,
      "type": null
    }
  ],
  "formation": "Oneota",
  "fossil_collections": 3,
  "fossil_occurrences": 5,
  "found": true,
  "group": "Prairie du Chien",
  "latitude": 43.233,
  "lithologies": [
    {
      "attributes": [],
      "class": "sedimentary",
      "lith_id": 31,
      "name": "dolomite",
      "proportion": 0.8333,
      "type": "carbonate"
    },
    {
      "attributes": [],
      "class": "sedimentary",
      "lith_id": 169,
      "name": "quartz arenite",
      "proportion": 0.1667,
      "type": "siliciclastic"
    }
  ],
  "lithology": "dolomite 83%, quartz arenite 17%",
  "longitude": -89.756,
  "max_thickness_m": 30.0,
  "measurement_types": [],
  "member": null,
  "min_thickness_m": 0.0,
  "name": "Oneonta Fm",
  "notes": null,
  "oldest_age_ma": 486.85,
  "oldest_interval": "Tremadocian",
  "outcrop": "both",
  "paleo_latitude_bottom": 15.762,
  "paleo_latitude_top": 11.351,
  "paleo_longitude_bottom": -103.39,
  "paleo_longitude_top": -103.368,
  "project_id": 1,
  "reference_ids": [
    1
  ],
  "section_id": 1463,
  "strat_name": "Oneota Formation",
  "strat_name_id": 7034,
  "supergroup": null,
  "unit_id": 6124,
  "units_above": [],
  "units_below": [
    6125
  ],
  "youngest_age_ma": 477.1,
  "youngest_interval": "Tremadocian"
}

Get a stratigraphic concept

Get a stratigraphic concept, which joins the names used for the same rocks, with its lexicon entry: its age, where the name comes from, the basins and provinces it is found in, usage notes, its names and a link to its source lexicon.

Inputs

ConceptconcepttextRequired
The concept's ID, which every stratigraphic name gives, or its exact name.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
authortext
Who wrote the entry, such as the USGS Geolex.
citationslist
The references for the entry, as citation lines.
concept_idnumber
The concept's ID.
foundtrue/false
False when Macrostrat has no such concept.
geologic_agetext
Its age in the lexicon's words.
intervaltext
The time interval it is assigned to.
lexicon_urltext
The entry in its source lexicon, such as Geolex.
macrostrat_urltext
The concept's page in Macrostrat's lexicon.
nametext
The concept's name, such as 'Mancos'.
nameslist
The stratigraphic names in the concept.
notestext
Other notes, such as where the name comes from and its type section.
oldest_intervaltext
The time interval it begins in.
provinceslist
The geologic provinces and basins it is found in.
usage_notestext
Notes on how the name is used.
youngest_intervaltext
The time interval it ends in.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "author": "USGS Lexicon",
  "citations": [
    "USGS Lexicon. Geolex: the U.S. Geologic Names Lexicon. 2015. http://ngmdb.usgs.gov/lex-bin/search.pl."
  ],
  "concept_id": 9165,
  "found": true,
  "geologic_age": "Late Cretaceous (Cenomanian to Campanian); locally late Early Cretaceous (Albian)",
  "interval": "Albian",
  "lexicon_url": "http://ngmdb.usgs.gov/Geolex/Units/Mancos_9165.html",
  "macrostrat_url": "https://macrostrat.org/lex/strat-concepts/9165",
  "name": "Mancos",
  "names": [
    {
      "name": "Mancos Group",
      "rank": "Gp",
      "rank_name": "Group",
      "strat_name_id": 72005,
      "unit_count": 0
    },
    {
      "name": "Mancos Shale",
      "rank": "Fm",
      "rank_name": "Formation",
      "strat_name_id": 1205,
      "unit_count": 22
    },
    {
      "name": "Mancos Shale Member",
      "rank": "Mbr",
      "rank_name": "Member",
      "strat_name_id": 80526,
      "unit_count": 0
    }
  ],
  "notes": "Named from occurrence in Mancos Valley and around town of Mancos, between La Plata Mountains and Mesa Verde, Montezuma Co., CO (Cross, 1899). Type section (subsurface) for \"Mancos B\" subsurface unit within Mancos shale...",
  "oldest_interval": "Cenomanian",
  "provinces": [
    "Basin-and-Range province",
    "Black Mesa basin",
    "Estancia basin",
    "Green River basin",
    "Orogrande basin",
    "Paradox basin",
    "Piceance basin",
    "Plateau sedimentary province",
    "San Juan basin",
    "San Juan Mountains province",
    "Uinta basin"
  ],
  "usage_notes": null,
  "youngest_interval": "Campanian"
}

Get a stratigraphic name

Get one stratigraphic name by its ID, with its rank, age, source and every name in its hierarchy: the group it is in, the formations beside it and their members and beds. 'Found' is false when Macrostrat has no such name.

Inputs

Stratigraphic namestrat_nametextRequired
The name's ID, which 'Search stratigraphic names' and every rock unit give.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
bedtext
The bed, when it is one.
bed_idnumber
That bed's name ID.
citationtext
That reference as a citation line.
concept_idnumber
Its concept, which joins names for the same rocks. 'Get a stratigraphic concept' takes it.
formationtext
The formation it is, or is in.
formation_idnumber
That formation's name ID.
foundtrue/false
False when Macrostrat has no name with this ID.
full_nametext
The name with its rank, such as 'Oneota Formation'.
grouptext
The group it is, or is in.
group_idnumber
That group's name ID.
hierarchylist
Every name in its hierarchy, largest rank first: its group, the formations in it, their members and beds.
intervaltext
The time interval it is assigned to, when one is.
macrostrat_urltext
The name's page in Macrostrat's lexicon.
membertext
The member it is, or is in.
member_idnumber
That member's name ID.
nametext
The name, such as 'Oneota'.
oldest_age_manumber
When it begins: its oldest age, in millions of years ago (Ma).
oldest_periodtext
The geologic period its oldest age falls in.
ranktext
Its rank: SGp, Gp, SubGp, Fm, Mbr or Bed.
rank_nametext
Its rank in words: Supergroup, Group, Formation and so on.
ref_idnumber
The reference the name comes from.
strat_name_idnumber
The name's ID. 'Get a stratigraphic name' takes it.
subgrouptext
The subgroup it is in.
subgroup_idnumber
That subgroup's name ID.
supergrouptext
The supergroup it is in.
supergroup_idnumber
That supergroup's name ID.
unit_countnumber
How many Macrostrat rock units carry the name.
youngest_age_manumber
When it ends: its youngest age, in millions of years ago (Ma).
youngest_periodtext
The geologic period its youngest age falls in.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "bed": null,
  "bed_id": null,
  "citation": "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985.",
  "concept_id": 3108,
  "formation": "Oneota",
  "formation_id": 7034,
  "found": true,
  "full_name": "Oneota Formation",
  "group": "Prairie du Chien",
  "group_id": 2622,
  "hierarchy": [
    {
      "is_this_name": false,
      "name": "Prairie du Chien Group",
      "rank": "Gp",
      "rank_name": "Group",
      "strat_name_id": 2622,
      "unit_count": 49
    },
    {
      "is_this_name": false,
      "name": "Foster Formation",
      "rank": "Fm",
      "rank_name": "Formation",
      "strat_name_id": 62444,
      "unit_count": 0
    },
    {
      "is_this_name": false,
      "name": "New Richmond Sandstone",
      "rank": "Fm",
      "rank_name": "Formation",
      "strat_name_id": 3363,
      "unit_count": 3
    },
    {
      "is_this_name": false,
      "name": "Oneota Dolomite",
      "rank": "Fm",
      "rank_name": "Formation",
      "strat_name_id": 3971,
      "unit_count": 14
    },
    {
      "is_this_name": true,
      "name": "Oneota Formation",
      "rank": "Fm",
      "rank_name": "Formation",
      "strat_name_id": 7034,
      "unit_count": 9
    },
    {
      "is_this_name": false,
      "name": "Shakopee Dolomite",
      "rank": "Fm",
      "rank_name": "Formation",
      "strat_name_id": 3992,
      "unit_count": 4
    }
  ],
  "interval": null,
  "macrostrat_url": "https://macrostrat.org/lex/strat-names/7034",
  "member": null,
  "member_id": null,
  "name": "Oneota",
  "oldest_age_ma": 486.85,
  "oldest_period": "Ordovician",
  "rank": "Fm",
  "rank_name": "Formation",
  "ref_id": 1,
  "strat_name_id": 7034,
  "subgroup": null,
  "subgroup_id": null,
  "supergroup": null,
  "supergroup_id": null,
  "unit_count": 9,
  "youngest_age_ma": 477.1,
  "youngest_period": "Ordovician"
}

Get the geology at a point

Find out what rock is at a place: the map unit of the most detailed geologic map there, with its name, age in millions of years and named intervals, rock types, description, the Macrostrat rock units matched to it, any fault mapped there, the ground's elevation and the map's citation.

Inputs

LatitudelatitudenumberRequired
The point's latitude in decimal degrees, from -90 (south) to 90 (north).From -90 to 90.
LongitudelongitudenumberRequired
The point's longitude in decimal degrees, from -180 (west) to 180 (east).From -180 to 180.
Map detailmap_detailtext
Which map to read: the most detailed one that covers the point, or a regional, continental or global one for the broader picture.One of: most_detailed (Most detailed map available), regional (Regional map), continental (Continental map), global (Global map). Default: most_detailed.

Outputs

agetext
The age as words and numbers, oldest first, such as 'Paibian to Tremadocian, 497 to 477.1 Ma' (Ma: millions of years ago).
attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
colortext
The color the map shows it in, as a hex code.
commentstext
The map's notes on it.
descriptiontext
The map's description of the rock.
elevation_mnumber
The ground's height there in metres, below zero under the sea.
foundtrue/false
True when a geologic map covers the point. Open ocean is often not mapped.
latitudenumber
The point's latitude.
lineobject
A fault or other line mapped at or right by the point.
lithologytext
The rock types as the map writes them.
lithology_idslist
The IDs of its rock types.
longitudenumber
The point's longitude.
macrostrat_unit_idslist
The Macrostrat rock units matched to it. 'Get a rock unit' takes each.
map_idnumber
The map polygon's ID in Macrostrat.
map_urltext
The point on Macrostrat's map, to open in a browser.
nametext
The map unit's name, such as 'Wonewoc Formation (Cw)'.
oldest_age_manumber
When it begins: its oldest age, in millions of years ago (Ma).
oldest_intervaltext
The time interval its oldest age falls in, such as 'Paibian'.
scaletext
How detailed the map is: large (local), medium (regional), small (continental) or tiny (global).
sourceobject
The geologic map this comes from, with its citation.
source_idnumber
The ID of the map it is from.
strat_nametext
The stratigraphic names the map gives it, such as 'Shakopee Formation; Oneota Formation'.
strat_name_idslist
The stratigraphic names matched to it. 'Get a stratigraphic name' takes each.
units_summaryobject
What Macrostrat's rock units matched to this map unit say about it.
youngest_age_manumber
When it ends: its youngest age, in millions of years ago (Ma).
youngest_intervaltext
The time interval its youngest age falls in, such as 'Tremadocian'.
Example output
{
  "age": "Cambrian, 538.8 to 486.85 Ma",
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "color": "#B3E095",
  "comments": null,
  "description": "Quartz sandstone, medium grained, brownish yellow to white, with medium- to large-scale cross bedding commonly seen in outcrop. Reaches a maximum thickness of 165 feet (50 m) in the subsurface. Part of Elk Mound Group.",
  "elevation_m": 264,
  "found": true,
  "latitude": 43.07,
  "line": {
    "description": null,
    "direction": null,
    "found": false,
    "line_id": null,
    "name": null,
    "scale": null,
    "source": {
      "authors": null,
      "citation": null,
      "doi": null,
      "name": null,
      "publisher": null,
      "source_id": null,
      "title": null,
      "url": null,
      "year": null
    },
    "type": null
  },
  "lithology": null,
  "lithology_ids": [
    10
  ],
  "longitude": -89.4,
  "macrostrat_unit_ids": [
    3078
  ],
  "map_id": 934954,
  "map_url": "https://macrostrat.org/map/loc/-89.4/43.07",
  "name": "Wonewoc Formation (Cw)",
  "oldest_age_ma": 538.8,
  "oldest_interval": "Cambrian",
  "scale": "large",
  "source": {
    "authors": "Brown, B.A., Peters, R.M., Massie-Ferch, K.",
    "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. (2013). Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report. https://wgnhs.uwex.edu/pubs/wofr201301di/",
    "doi": null,
    "name": "Dane County, WI",
    "publisher": "Open-File Report",
    "source_id": 6,
    "title": "Preliminary Bedrock Geology of Dane County, Wisconsin",
    "url": "https://wgnhs.uwex.edu/pubs/wofr201301di/",
    "year": "2013"
  },
  "source_id": 6,
  "strat_name": "Wonewoc Formation",
  "strat_name_ids": [
    2329,
    66515
  ],
  "units_summary": {
    "age": "Dresbachian to Franconian, 497.5 to 493.575 Ma",
    "economic_uses": [
      {
        "class": "water",
        "econ_id": 17,
        "name": "aquifer",
        "proportion": 1.0,
        "type": "aquifer"
      }
    ],
    "environments": [
      {
        "class": "marine",
        "environ_id": 93,
        "name": "inferred marine",
        "proportion": 1.0,
        "type": null
      }
    ],
    "fossil_collections": 0,
    "found": true,
    "lithologies": [
      {
        "attributes": [],
        "class": "sedimentary",
        "lith_id": 10,
        "name": "sandstone",
        "proportion": 1.0,
        "type": "siliciclastic"
      }
    ],
    "lithology": "sandstone 100%",
    "max_thickness_m": 27.0,
    "names": "Wonewoc Formation",
    "oldest_age_ma": 497.5,
    "oldest_interval": "Dresbachian",
    "strat_names": [
      {
        "name": "Wonewoc Formation",
        "strat_name_id": 2329
      },
      {
        "name": "Wonewoc Formation",
        "strat_name_id": 66515
      }
    ],
    "unit_ids": [
      3078
    ],
    "youngest_age_ma": 493.575,
    "youngest_interval": "Franconian"
  },
  "youngest_age_ma": 486.85,
  "youngest_interval": "Cambrian"
}

List fossil collections

List the Paleobiology Database fossil collections matched to a rock unit, a column, a stratigraphic name, a time interval or an age, each with its age, how many fossils it holds and a link to it.

Inputs

Rock unitunittext
Only those of this rock unit, by its ID from 'Search rock units'.
Columncolumntext
Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
Stratigraphic namestrat_name_idtext
Only collections from rocks of this stratigraphic name, by its ID from 'Search stratigraphic names'.
Time intervalintervaltext
Only those of this geologic time interval, such as the Permian or the Tremadocian. Pick one from the international time scale, or type any other interval's name or ID.
Age (Ma)age_manumber
Only collections from rocks of this age, in millions of years ago, such as 271.From 0 to 4600.0.
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
collectionslist
The fossil collections, youngest first.
countnumber
How many are in this answer.
more_availabletrue/false
True when there is a next page.
pagenumber
Which page this is, from 1.
referenceslist
The publications the results cite, by the reference ID each result names.
totalnumber
How many matched.
Example output
{
  "attribution": "Fossil collections from the Paleobiology Database (https://paleobiodb.org), matched to rock units by Macrostrat (https://macrostrat.org), CC BY 4.0.",
  "collections": [
    {
      "collection_id": 189305,
      "column_id": 187,
      "name": "1.5 miles north of Albany",
      "occurrences": 2,
      "oldest_age_ma": 486.85,
      "pbdb_url": "https://paleobiodb.org/classic/basicCollectionSearch?collection_no=189305",
      "reference_ids": [
        8
      ],
      "strat_name_concept_id": 3108,
      "unit_id": 6124,
      "youngest_age_ma": 477.1
    },
    {
      "collection_id": 189391,
      "column_id": 187,
      "name": "near Madison",
      "occurrences": 1,
      "oldest_age_ma": 486.85,
      "pbdb_url": "https://paleobiodb.org/classic/basicCollectionSearch?collection_no=189391",
      "reference_ids": [
        8
      ],
      "strat_name_concept_id": 3108,
      "unit_id": 6124,
      "youngest_age_ma": 477.1
    },
    {
      "collection_id": 189393,
      "column_id": 187,
      "name": "Wilson's quarry near Madison",
      "occurrences": 2,
      "oldest_age_ma": 486.85,
      "pbdb_url": "https://paleobiodb.org/classic/basicCollectionSearch?collection_no=189393",
      "reference_ids": [
        8
      ],
      "strat_name_concept_id": 3108,
      "unit_id": 6124,
      "youngest_age_ma": 477.1
    }
  ],
  "count": 3,
  "more_available": true,
  "page": 1,
  "references": [
    {
      "citation": "Paleobiology Database. 2015. https://paleobiodb.org.",
      "ref_id": 8
    }
  ],
  "total": 5
}

List map units at a point

List every geologic map unit at a place, from the most detailed local map to the global one, each with its age, rock types, description, matched Macrostrat units and its map's citation.

Inputs

LatitudelatitudenumberRequired
The point's latitude in decimal degrees, from -90 (south) to 90 (north).From -90 to 90.
LongitudelongitudenumberRequired
The point's longitude in decimal degrees, from -180 (west) to 180 (east).From -180 to 180.
Map scalesscaleslist
Only maps of these scales, from local maps (the most detailed) to global ones. Leave empty for every scale.One or more of: large (Local (most detailed)), medium (Regional), small (Continental), tiny (Global).

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many map units cover the point.
latitudenumber
The point's latitude.
longitudenumber
The point's longitude.
map_urltext
The point on Macrostrat's map.
sourceslist
The publications the results cite, by the reference ID each result names.
unitslist
Every map unit at the point, the most detailed map first.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 4,
  "latitude": 43.07,
  "longitude": -89.4,
  "map_url": "https://macrostrat.org/map/loc/-89.4/43.07",
  "sources": [
    {
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report.",
      "ref_id": 6
    },
    {
      "citation": "Garrity, C.P., and Soller, D.R. Database of the Geologic Map of North America: adapted from the map by J.C. Reed, Jr. and others (2005). U.S. Geological Survey Data Series 424.",
      "ref_id": 7
    },
    {
      "citation": "Horton, J.D., C.A. San Juan, and D.B. Stoeser. The State Geologic Map Compilation (SGMC) geodatabase of the conterminous United States. doi: 10.3133/ds1052. U.S. Geological Survey Data Series 1052.",
      "ref_id": 133
    },
    {
      "citation": "Chorlton, L.B. Generalized geology of the world: bedrock domains and major faults in GIS format: a small-scale world geology map with an extended geological attribute database. doi: 10.4095/223767. Geological Survey of...",
      "ref_id": 154
    }
  ],
  "units": [
    {
      "age": "Cambrian, 497.5 to 493.575 Ma",
      "best_interval": "Cambrian",
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report.",
      "color": "#B3E095",
      "comments": null,
      "description": "Quartz sandstone, medium grained, brownish yellow to white, with medium- to large-scale cross bedding commonly seen in outcrop. Reaches a maximum thickness of 165 feet (50 m) in the subsurface. Part of Elk Mound Group.",
      "lithology": null,
      "lithology_ids": [
        10
      ],
      "macrostrat_unit_ids": [
        3078
      ],
      "map_id": 934954,
      "name": "Wonewoc Formation (Cw)",
      "oldest_age_ma": 497.5,
      "oldest_interval": "Cambrian",
      "scale": "large",
      "source_id": 6,
      "strat_name": "Wonewoc Formation",
      "strat_name_ids": [
        2329,
        66515
      ],
      "youngest_age_ma": 493.575,
      "youngest_interval": "Cambrian"
    },
    {
      "age": "Cambrian, 496.8 to 492.5 Ma",
      "best_interval": "Furongian",
      "citation": "Horton, J.D., C.A. San Juan, and D.B. Stoeser. The State Geologic Map Compilation (SGMC) geodatabase of the conterminous United States. doi: 10.3133/ds1052. U.S. Geological Survey Data Series 1052.",
      "color": "#D9EABA",
      "comments": "Original map source: Cannon, W.F., Kress, T.H., Sutphin, D.M., Morey, G.B., Meints, Joyce, and Barber-Delach, Robert, 1997, Digital Geologic Map and mineral deposits of the Lake Superior Region, Minnesota, Wisconsin...",
      "description": "Sandstone with some dolomite and shale, undivided; includes Trempealeau, Tunnel City, and Elk Mound Formations",
      "lithology": "Major:{sandstone}, Minor:{dolostone,shale}",
      "lithology_ids": [
        8,
        10,
        31
      ],
      "macrostrat_unit_ids": [
        6127,
        6142
      ],
      "map_id": 2985493,
      "name": "Cambrian, undivided",
      "oldest_age_ma": 496.8,
      "oldest_interval": "Cambrian",
      "scale": "medium",
      "source_id": 133,
      "strat_name": "Trempealeau Formation; Tunnel City Formation; Elk Mound Formation",
      "strat_name_ids": [
        2130,
        66114,
        78384
      ],
      "youngest_age_ma": 492.5,
      "youngest_interval": "Cambrian"
    },
    {
      "age": "Cambrian, 541 to 485.4 Ma",
      "best_interval": null,
      "citation": "Garrity, C.P., and Soller, D.R. Database of the Geologic Map of North America: adapted from the map by J.C. Reed, Jr. and others (2005). U.S. Geological Survey Data Series 424.",
      "color": "#7FA056",
      "comments": null,
      "description": null,
      "lithology": "sedimentary",
      "lithology_ids": [
        111
      ],
      "macrostrat_unit_ids": [],
      "map_id": 951240,
      "name": "Cambrian sedimentary",
      "oldest_age_ma": 541.0,
      "oldest_interval": "Cambrian",
      "scale": "small",
      "source_id": 7,
      "strat_name": null,
      "strat_name_ids": [],
      "youngest_age_ma": 485.4,
      "youngest_interval": "Cambrian"
    },
    {
      "age": "Paleozoic, 541 to 251.902 Ma",
      "best_interval": null,
      "citation": "Chorlton, L.B. Generalized geology of the world: bedrock domains and major faults in GIS format: a small-scale world geology map with an extended geological attribute database. doi: 10.4095/223767. Geological Survey of...",
      "color": "#99C08D",
      "comments": null,
      "description": null,
      "lithology": "sedimentary rocks",
      "lithology_ids": [
        111
      ],
      "macrostrat_unit_ids": [],
      "map_id": 3187973,
      "name": "Paleozoic sedimentary rocks",
      "oldest_age_ma": 541.0,
      "oldest_interval": "Paleozoic",
      "scale": "tiny",
      "source_id": 154,
      "strat_name": null,
      "strat_name_ids": [],
      "youngest_age_ma": 251.902,
      "youngest_interval": "Paleozoic"
    }
  ]
}

List measurements

List the measurements made on samples of a rock unit or column, or every measurement of one kind: element concentrations, isotopes, radiometric ages and paleocurrent directions, each with its values, sample and source.

Inputs

Rock unitunittext
Only those of this rock unit, by its ID from 'Search rock units'.
Columncolumntext
Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
Measurementmeasurementtext
Only this kind of measurement, such as Ba or 238U-206Pb. Give this, a 'Rock unit' or a 'Column'.
Kind of measurementmeasurement_typetext
Only measurements of this kind.One of: geochronological (Geochronological (radiometric ages)), stable isotopes, radiogenic isotopes, major elements, minor elements, petrologic, material properties, environmental (Environmental (such as transport direction)).
Time intervalintervaltext
Only those of this geologic time interval, such as the Permian or the Tremadocian. Pick one from the international time scale, or type any other interval's name or ID.
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
measurementslist
The measurements, one row per sample and kind.
more_availabletrue/false
True when there is a next page.
pagenumber
Which page this is, from 1.
referenceslist
The publications the results cite, by the reference ID each result names.
totalnumber
How many matched.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 2,
  "measurements": [
    {
      "citation": "L. Brand, M. Wang, A Chadwick. Global database of paleocurrent trends through the Phanerozoic and Precambrian. Scientific Data 2:150025. 2015. 10.1038/sdata.2015.2. http://www.nature.com/articles/sdata201525.",
      "column_id": 187,
      "error_units": "dispersion",
      "errors": [
        65.0
      ],
      "latitude": 43.78,
      "longitude": -91.15,
      "match_basis": "rank_equal",
      "measurement": "transport direction",
      "measurement_id": 80,
      "method": "crossbedding",
      "phase": "whole rock",
      "reference": "Brand & Chadwick (2015)",
      "sample_age": null,
      "sample_description": "27 measurements (crossbedding) from 50 km^2",
      "sample_id": 27508,
      "sample_lithology": null,
      "sample_name": "North American 8",
      "sample_unit": "Jordan",
      "strat_name_id": 995,
      "unit_id": 6125,
      "units": "azimuth",
      "value_count": 1,
      "values": [
        270.0
      ]
    },
    {
      "citation": "L. Brand, M. Wang, A Chadwick. Global database of paleocurrent trends through the Phanerozoic and Precambrian. Scientific Data 2:150025. 2015. 10.1038/sdata.2015.2. http://www.nature.com/articles/sdata201525.",
      "column_id": 187,
      "error_units": "dispersion",
      "errors": [
        65.0
      ],
      "latitude": 43.74,
      "longitude": -91.2,
      "match_basis": "rank_equal",
      "measurement": "transport direction",
      "measurement_id": 80,
      "method": "crossbedding",
      "phase": "whole rock",
      "reference": "Brand & Chadwick (2015)",
      "sample_age": null,
      "sample_description": "21 measurements (crossbedding) from 50 km^2",
      "sample_id": 27509,
      "sample_lithology": null,
      "sample_name": "North American 8",
      "sample_unit": "Jordan",
      "strat_name_id": 995,
      "unit_id": 6125,
      "units": "azimuth",
      "value_count": 1,
      "values": [
        265.0
      ]
    }
  ],
  "more_available": true,
  "page": 1,
  "references": [
    {
      "citation": "L. Brand, M. Wang, A Chadwick. Global database of paleocurrent trends through the Phanerozoic and Precambrian. Scientific Data 2:150025. 2015. 10.1038/sdata.2015.2. http://www.nature.com/articles/sdata201525.",
      "ref_id": 18
    },
    {
      "citation": "Puetz, S.J. A relational database of global U-Pb ages. Geoscience Frontiers 9:877-891. 2018. 10.1016/j.gsf.2017.12.004. https://www.sciencedirect.com/science/article/pii/S1674987117302141.",
      "ref_id": 51
    }
  ],
  "total": 141
}

Look up a mineral

Look up minerals by name, or the start of one, or by group, such as feldspar: each with its chemical formula, hardness, crystal system, colors, lustre and its mindat.org page.

Inputs

Mineral namenametext
A mineral's name, such as quartz, or its start, such as quar. Give this, a 'Mineral group', or both.
Mineral groupmineral_typetext
Only minerals of this group.One of: aluminosilicate, amphibole, carbonate, chlorite, clinopyroxene, cyclosilicate, element, feldspar, garnet, inosilicate, and 8 more.
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
mineralslist
The minerals, an exact name first, then in order of name.
more_availabletrue/false
True when more matched than the limit.
totalnumber
How many minerals matched.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 2,
  "minerals": [
    {
      "colors": "Colorless, purple, rose, red, black, yellow, brown, green, blue, orange, etc.",
      "crystal_system": "Trigonal",
      "formula": "SiO2",
      "hardness_max": 7.0,
      "hardness_min": 7.0,
      "lustre": "Vitreous",
      "macrostrat_url": "https://macrostrat.org/lex/minerals/3337",
      "mindat_url": "http://www.mindat.org/min-3337.html",
      "mineral_id": 3337,
      "name": "Quartz",
      "type": null
    },
    {
      "colors": null,
      "crystal_system": "Hexagonal",
      "formula": "SiO2",
      "hardness_max": null,
      "hardness_min": null,
      "lustre": null,
      "macrostrat_url": "https://macrostrat.org/lex/minerals/7395",
      "mindat_url": "http://www.mindat.org/min-7395.html",
      "mineral_id": 7395,
      "name": "Quartz-beta",
      "type": null
    }
  ],
  "more_available": false,
  "total": 2
}

Look up a time interval

Look up a geologic time interval, such as the Permian or the Tremadocian: when it began and ended in millions of years, how long it lasted, its kind, its color on time scale charts, the eon, era, period and epoch it is part of, and its timescales.

Inputs

Time intervalintervaltextRequired
The interval to look up. Pick one from the international time scale, or type any interval's name or ID.

Outputs

abbreviationtext
Its abbreviation, such as 'P'.
attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
colortext
Its standard color on time scale charts, as a hex code.
duration_myrnumber
How long it lasted, in millions of years.
foundtrue/false
False when no interval has exactly this name; 'other_matches' then lists those whose names hold it.
int_idnumber
The interval's ID. 'Look up a time interval' takes it.
macrostrat_urltext
The interval's page in Macrostrat's lexicon.
nametext
The interval's name, such as 'Permian'.
oldest_age_manumber
When it begins, in millions of years ago (Ma).
other_matcheslist
Other intervals whose names hold the text, such as 'Late Permian'.
part_oflist
The international eon, era, period and epoch it falls in, broadest first.
timescaleslist
The timescales it belongs to.
typetext
What kind of interval it is: eon, era, period, epoch, age, zone...
youngest_age_manumber
When it ends, in millions of years ago (Ma).
Example output
{
  "abbreviation": null,
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "color": "#33A97E",
  "duration_myr": 9.75,
  "found": true,
  "int_id": 121,
  "macrostrat_url": "https://macrostrat.org/lex/intervals/121",
  "name": "Tremadocian",
  "oldest_age_ma": 486.85,
  "other_matches": [],
  "part_of": [
    {
      "int_id": 275,
      "name": "Phanerozoic",
      "oldest_age_ma": 538.8,
      "type": "eon",
      "youngest_age_ma": 0.0
    },
    {
      "int_id": 74,
      "name": "Paleozoic",
      "oldest_age_ma": 538.8,
      "type": "era",
      "youngest_age_ma": 251.902
    },
    {
      "int_id": 112,
      "name": "Ordovician",
      "oldest_age_ma": 486.85,
      "type": "period",
      "youngest_age_ma": 443.1
    },
    {
      "int_id": 119,
      "name": "Early Ordovician",
      "oldest_age_ma": 486.85,
      "type": "epoch",
      "youngest_age_ma": 471.3
    }
  ],
  "timescales": [
    {
      "name": "international ages",
      "timescale_id": 1
    },
    {
      "name": "custom COSUNA",
      "timescale_id": 7
    },
    {
      "name": "international intervals",
      "timescale_id": 11
    },
    {
      "name": "COSUNA",
      "timescale_id": 12
    },
    {
      "name": "Russian Stages",
      "timescale_id": 40
    }
  ],
  "type": "age",
  "youngest_age_ma": 477.1
}

Search geologic map units

Find the units of geologic maps anywhere in the world by words in their descriptions, such as banded iron, or list one map's legend, with each unit's age, rock types, description and map citation, the largest first.

Inputs

Description wordsdescriptiontext
Words to find in map units' descriptions, such as banded iron or pillow basalt. Give these, a 'Map', or both.
Mapmap_sourcetext
Only units of this geologic map. Pick one, or type the map's ID from 'Find geologic maps'.
Rock typelithologytext
Only these rocks: a whole class (all igneous rocks), a type (all carbonate rocks) or one lithology, such as sandstone. A lithology's name can be typed too.
Map scalesscaleslist
Only maps of these scales, from local maps (the most detailed) to global ones. Leave empty for every scale.One or more of: large (Local (most detailed)), medium (Regional), small (Continental), tiny (Global).
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
more_availabletrue/false
True when there is a next page.
pagenumber
Which page this is, from 1.
sourceslist
The publications the results cite, by the reference ID each result names.
totalnumber
How many matched.
unitslist
The map units, the largest area first.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 3,
  "more_available": true,
  "page": 1,
  "sources": [
    {
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report.",
      "ref_id": 6
    }
  ],
  "total": 9,
  "units": [
    {
      "age": "Ordovician",
      "area_km2": 808.1,
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report.",
      "color": "#1A9D6F",
      "comments": null,
      "description": "Dolomite, minor sandstone, cherty dolomite; vuggy, sandy, and oolitic. Consists of two formations, the Shakopee and the Oneota. It varies in thickness from 145 feet (44 m) in eastern Dane County to 220 feet (67 m) in...",
      "legend_id": 12519,
      "lithology": null,
      "lithology_classes": [
        "sedimentary"
      ],
      "lithology_ids": [
        10,
        31
      ],
      "lithology_types": [
        "carbonate",
        "siliciclastic"
      ],
      "macrostrat_unit_ids": [
        6139
      ],
      "name": "Prairie du Chien Group (Op)",
      "oldest_age_ma": 485.4,
      "scale": "large",
      "source_id": 6,
      "strat_name": "Prairie du Chien Group",
      "strat_name_ids": [
        2622,
        64984
      ],
      "youngest_age_ma": 470.0
    },
    {
      "age": "Ordovician",
      "area_km2": 800.9,
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report.",
      "color": "#8ED195",
      "comments": null,
      "description": "Glenwood Formation: Sandstone, siltstone, and/or shale. St. Peter Formation: upper Tonti Member is a medium-grained, mature quartz sandstone; basal Readstown Member is immature, consisting of red-brown shale, sandstone...",
      "legend_id": 12515,
      "lithology": null,
      "lithology_classes": [
        "sedimentary"
      ],
      "lithology_ids": [
        8,
        9,
        10,
        14,
        45
      ],
      "lithology_types": [
        "chemical",
        "siliciclastic"
      ],
      "macrostrat_unit_ids": [
        3101,
        11225,
        11556
      ],
      "name": "Ancell Group (Oa)",
      "oldest_age_ma": 458.4,
      "scale": "large",
      "source_id": 6,
      "strat_name": "Glenwood Formation; St. Peter Formation",
      "strat_name_ids": [
        757,
        7763
      ],
      "youngest_age_ma": 456.975
    },
    {
      "age": "Cambrian",
      "area_km2": 483.4,
      "citation": "Brown, B.A., Peters, R.M., Massie-Ferch, K. Preliminary Bedrock Geology of Dane County, Wisconsin. Open-File Report.",
      "color": "#E0F0C1",
      "comments": null,
      "description": "Quartz sandstone, dolomitic siltstone, silty dolomite, and sandy dolomite. Consists of two formations, the Jordan and the underlying St. Lawrence, which were combined as one mapping unit. Thickness is about 75 feet (23...",
      "legend_id": 12521,
      "lithology": null,
      "lithology_classes": [
        "sedimentary"
      ],
      "lithology_ids": [
        9,
        10,
        31
      ],
      "lithology_types": [
        "carbonate",
        "siliciclastic"
      ],
      "macrostrat_unit_ids": [
        6125,
        6126
      ],
      "name": "Trempealeau Group (Ct)",
      "oldest_age_ma": 492.5,
      "scale": "large",
      "source_id": 6,
      "strat_name": "Jordan Formation; St. Lawrence Formation",
      "strat_name_ids": [
        995,
        65745
      ],
      "youngest_age_ma": 485.4
    }
  ]
}

Search rock units

Find rock units (formations, members and beds in Macrostrat's columns) by stratigraphic name, age, rock type, environment, economic use, place or column, each with its age and named intervals, thickness, rock types and their shares, environments and the references it is compiled from.

Inputs

Stratigraphic namestrat_nametext
A formation, group or member name, such as Mancos or Green River. Macrostrat matches it loosely, so 'Mancos' finds the Mancos Shale and its members.
Time intervalintervaltext
Only those of this geologic time interval, such as the Permian or the Tremadocian. Pick one from the international time scale, or type any other interval's name or ID.
Age (Ma)age_manumber
Only rocks of this age, in millions of years ago (Ma), such as 271. Use this or an age range, not both.From 0 to 4600.0.
Youngest age (Ma)youngest_age_manumber
With 'Oldest age (Ma)', only rocks that formed at some time between the two ages. Ages count back from today, so this is the smaller number. Leave it empty for up to today.From 0 to 4600.0.
Oldest age (Ma)oldest_age_manumber
The older end of the age range, in millions of years ago, such as 260. Leave it empty for back to the Earth's beginning.From 0 to 4600.0.
Rock typelithologytext
Only these rocks: a whole class (all igneous rocks), a type (all carbonate rocks) or one lithology, such as sandstone. A lithology's name can be typed too.
Environmentenvironmenttext
Only rocks that formed in this environment: a class (marine or non-marine), a type (such as fluvial) or one environment, such as deltaic. An environment's name can be typed too.
Economic useeconomic_usetext
Only rocks with this economic use or resource: a class (energy, material, precious commodity or water), a type (such as hydrocarbon) or one use, such as coal or aquifer.
Latitudelatitudenumber
To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'.From -90 to 90.
Longitudelongitudenumber
To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'.From -180 to 180.
Include neighbouring columnsinclude_adjacenttrue/false
Also include the columns that touch the one at the place (or the 'Column' given), for a wider look at the region.Default: false.
Columncolumntext
Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
Projectprojecttext
Only columns of this Macrostrat project: a region such as North America or New Zealand, or the offshore drilling sites.
Orderordertext
Youngest first (the top of a column down), or oldest first.One of: youngest_first (Youngest first (top of the column down)), oldest_first (Oldest first). Default: youngest_first.
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
more_availabletrue/false
True when there is a next page.
pagenumber
Which page this is, from 1.
referenceslist
The publications the results cite, by the reference ID each result names.
totalnumber
How many matched.
unitslist
The rock units, in the order chosen.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 2,
  "more_available": true,
  "page": 1,
  "references": [
    {
      "citation": "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985.",
      "ref_id": 1
    }
  ],
  "total": 22,
  "units": [
    {
      "age": "Coniacian to Campanian, 89.8 to 75.05 Ma",
      "citations": [
        "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985."
      ],
      "color": "#999999",
      "column_id": 501,
      "column_url": "https://macrostrat.org/columns/501",
      "economic_uses": [],
      "environments": [
        {
          "class": "marine",
          "environ_id": 28,
          "name": "offshore",
          "proportion": null,
          "type": "siliciclastic"
        }
      ],
      "formation": "Mancos Shale",
      "fossil_collections": 37,
      "fossil_occurrences": 197,
      "group": null,
      "latitude": 40.144,
      "lithologies": [
        {
          "attributes": [],
          "class": "sedimentary",
          "lith_id": 8,
          "name": "shale",
          "proportion": 0.7143,
          "type": "siliciclastic"
        },
        {
          "attributes": [],
          "class": "sedimentary",
          "lith_id": 30,
          "name": "limestone",
          "proportion": 0.1429,
          "type": "carbonate"
        },
        {
          "attributes": [],
          "class": "sedimentary",
          "lith_id": 10,
          "name": "sandstone",
          "proportion": 0.1429,
          "type": "siliciclastic"
        }
      ],
      "lithology": "shale 71%, limestone 14%, sandstone 14%",
      "longitude": -109.262,
      "max_thickness_m": 1485.0,
      "measurement_types": [
        "sedimentological environmental"
      ],
      "member": null,
      "min_thickness_m": 0.0,
      "name": "Mancos Shale",
      "notes": "environ- Kass 1999",
      "oldest_age_ma": 89.8,
      "oldest_interval": "Coniacian",
      "outcrop": "both",
      "paleo_latitude_bottom": 47.734,
      "paleo_latitude_top": 51.062,
      "paleo_longitude_bottom": -67.74,
      "paleo_longitude_top": -70.926,
      "project_id": 1,
      "reference_ids": [
        1
      ],
      "section_id": 4094,
      "strat_name": "Mancos Shale",
      "strat_name_id": 1205,
      "supergroup": null,
      "unit_id": 15434,
      "units_above": [
        15433
      ],
      "units_below": [
        15435
      ],
      "youngest_age_ma": 75.05,
      "youngest_interval": "Campanian"
    },
    {
      "age": "Turonian to Campanian, 90.825 to 75.05 Ma",
      "citations": [
        "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985."
      ],
      "color": "#999999",
      "column_id": 500,
      "column_url": "https://macrostrat.org/columns/500",
      "economic_uses": [],
      "environments": [
        {
          "class": "marine",
          "environ_id": 28,
          "name": "offshore",
          "proportion": null,
          "type": "siliciclastic"
        }
      ],
      "formation": "Mancos Shale",
      "fossil_collections": 1,
      "fossil_occurrences": 14,
      "group": null,
      "latitude": 38.967,
      "lithologies": [
        {
          "attributes": [],
          "class": "sedimentary",
          "lith_id": 8,
          "name": "shale",
          "proportion": 1.0,
          "type": "siliciclastic"
        }
      ],
      "lithology": "shale 100%",
      "longitude": -107.8,
      "max_thickness_m": 1500.0,
      "measurement_types": [
        "geochemical major elements",
        "geochemical minor elements"
      ],
      "member": null,
      "min_thickness_m": 1000.0,
      "name": "Mancos Shale",
      "notes": "environ- Kass 1999",
      "oldest_age_ma": 90.825,
      "oldest_interval": "Turonian",
      "outcrop": "both",
      "paleo_latitude_bottom": 46.244,
      "paleo_latitude_top": 49.566,
      "paleo_longitude_bottom": -66.459,
      "paleo_longitude_top": -69.915,
      "project_id": 1,
      "reference_ids": [
        1
      ],
      "section_id": 4092,
      "strat_name": "Mancos Shale",
      "strat_name_id": 1205,
      "supergroup": null,
      "unit_id": 15419,
      "units_above": [
        15415,
        15418
      ],
      "units_below": [
        15420
      ],
      "youngest_age_ma": 75.05,
      "youngest_interval": "Campanian"
    }
  ]
}

Search stratigraphic names

Find stratigraphic names (supergroups, groups, formations, members and beds) that start with, contain or are exactly a name, by rank and age, each with its place in its hierarchy, age range, how many rock units carry it and its source.

Inputs

NamenametextRequired
The name to look for, such as Oneota or Green River.
Matchmatchtext
Names that start with it, contain it, or are exactly it.One of: starts_with (Starts with), contains, exact (Exactly). Default: starts_with.
Rankranktext
Only names of this rank. Leave empty for every rank.One of: SGp (Supergroup), Gp (Group), SubGp (Subgroup), Fm (Formation), Mbr (Member), Bed.
Time intervalintervaltext
Only those of this geologic time interval, such as the Permian or the Tremadocian. Pick one from the international time scale, or type any other interval's name or ID.
Limitlimitnumber
How many to return, from 1 to 100.From 1 to 100. Default: 25.
Pagepagenumber
Which page of results to return, from 1.From 1 to 1000. Default: 1.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many are in this answer.
more_availabletrue/false
True when there is a next page.
nameslist
The names, those carried by the most rock units first.
pagenumber
Which page this is, from 1.
totalnumber
How many matched.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 2,
  "more_available": true,
  "names": [
    {
      "bed": null,
      "bed_id": null,
      "citation": "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985.",
      "concept_id": 3108,
      "formation": "Oneota Dolomite",
      "formation_id": 3971,
      "full_name": "Oneota Dolomite",
      "group": "Prairie du Chien",
      "group_id": 2622,
      "interval": null,
      "macrostrat_url": "https://macrostrat.org/lex/strat-names/3971",
      "member": null,
      "member_id": null,
      "name": "Oneota Dolomite",
      "oldest_age_ma": 486.85,
      "oldest_period": "Ordovician",
      "rank": "Fm",
      "rank_name": "Formation",
      "ref_id": 1,
      "strat_name_id": 3971,
      "subgroup": null,
      "subgroup_id": null,
      "supergroup": null,
      "supergroup_id": null,
      "unit_count": 14,
      "youngest_age_ma": 477.1,
      "youngest_period": "Ordovician"
    },
    {
      "bed": null,
      "bed_id": null,
      "citation": "Childs, O.E. Correlation of stratigraphic units of North America; COSUNA. AAPG Bulletin 69:173-180. 1985.",
      "concept_id": 3108,
      "formation": "Oneota",
      "formation_id": 7034,
      "full_name": "Oneota Formation",
      "group": "Prairie du Chien",
      "group_id": 2622,
      "interval": null,
      "macrostrat_url": "https://macrostrat.org/lex/strat-names/7034",
      "member": null,
      "member_id": null,
      "name": "Oneota",
      "oldest_age_ma": 486.85,
      "oldest_period": "Ordovician",
      "rank": "Fm",
      "rank_name": "Formation",
      "ref_id": 1,
      "strat_name_id": 7034,
      "subgroup": null,
      "subgroup_id": null,
      "supergroup": null,
      "supergroup_id": null,
      "unit_count": 9,
      "youngest_age_ma": 477.1,
      "youngest_period": "Ordovician"
    }
  ],
  "page": 1,
  "total": 4
}

Search the dictionary

Find anything in Macrostrat's dictionary whose name starts with some text: time intervals, stratigraphic names, columns, rock types, environments, economic uses, minerals and more, each with its ID for the action that reads it. Up to 100 matches.

Inputs

Search textquerytextRequired
The start of a name, such as Mancos, Jur or gran.
Kinds of entrycategorieslist
Only these kinds of entry. Leave empty for every kind.One or more of: intervals (Time intervals), strat_names (Stratigraphic names), columns, groups (Column groups), projects, lithologies (Lithologies (rock types)), lithology_attributes (Lithology attributes), environments, econs (Economic uses), minerals, structures.

Outputs

attributiontext
The credit Macrostrat's CC BY 4.0 licence asks for, ready to show wherever the data is published, alongside the source citations given with the results.
countnumber
How many entries matched (at most 100).
matcheslist
The entries whose names start with the text, by kind.
Example output
{
  "attribution": "Data from Macrostrat (https://macrostrat.org), CC BY 4.0. Credit Macrostrat and the sources cited with each result.",
  "count": 5,
  "matches": [
    {
      "category": "intervals",
      "id": 48,
      "kind": "Time interval",
      "name": "Jurassic"
    },
    {
      "category": "intervals",
      "id": 979,
      "kind": "Time interval",
      "name": "Jurassic-Cretaceous"
    },
    {
      "category": "strat_name_concepts",
      "id": 18721,
      "kind": "Stratigraphic name concept",
      "name": "Jurabi"
    },
    {
      "category": "strat_name_concepts",
      "id": 18722,
      "kind": "Stratigraphic name concept",
      "name": "Jurgurra Sandstone"
    },
    {
      "category": "strat_name_concepts",
      "id": 25344,
      "kind": "Stratigraphic name concept",
      "name": "Juries Bore Granite"
    }
  ]
}

On this page