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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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
- Latitude
latitudenumber - To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'.From -90 to 90.
- Longitude
longitudenumber - To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'.From -180 to 180.
- Map scales
scaleslist - 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). - Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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
- Latitude
latitudenumber - To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'.From -90 to 90.
- Longitude
longitudenumber - To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'.From -180 to 180.
- Include neighbouring columns
include_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 name
strat_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 interval
intervaltext - 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 type
lithologytext - 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.
- Environment
environmenttext - 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 use
economic_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.
- Project
projecttext - Only columns of this Macrostrat project: a region such as North America or New Zealand, or the offshore drilling sites.
- Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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.
- Match
matchtext - 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. - Timescale
timescaletext - Only intervals of this timescale, such as the international periods or the North American land mammal ages. On its own, lists the whole timescale.
- Limit
limitnumber - 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
- Column
columntextRequired - 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 unit
unittextRequired - 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
- Concept
concepttextRequired - 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 name
strat_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
- Latitude
latitudenumberRequired - The point's latitude in decimal degrees, from -90 (south) to 90 (north).From -90 to 90.
- Longitude
longitudenumberRequired - The point's longitude in decimal degrees, from -180 (west) to 180 (east).From -180 to 180.
- Map detail
map_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 unit
unittext - Only those of this rock unit, by its ID from 'Search rock units'.
- Column
columntext - Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
- Stratigraphic name
strat_name_idtext - Only collections from rocks of this stratigraphic name, by its ID from 'Search stratigraphic names'.
- Time interval
intervaltext - 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.
- Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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
- Latitude
latitudenumberRequired - The point's latitude in decimal degrees, from -90 (south) to 90 (north).From -90 to 90.
- Longitude
longitudenumberRequired - The point's longitude in decimal degrees, from -180 (west) to 180 (east).From -180 to 180.
- Map scales
scaleslist - 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 unit
unittext - Only those of this rock unit, by its ID from 'Search rock units'.
- Column
columntext - Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
- Measurement
measurementtext - Only this kind of measurement, such as Ba or 238U-206Pb. Give this, a 'Rock unit' or a 'Column'.
- Kind of measurement
measurement_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 interval
intervaltext - 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.
- Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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 name
nametext - A mineral's name, such as quartz, or its start, such as quar. Give this, a 'Mineral group', or both.
- Mineral group
mineral_typetext - Only minerals of this group.One of:
aluminosilicate,amphibole,carbonate,chlorite,clinopyroxene,cyclosilicate,element,feldspar,garnet,inosilicate, and 8 more. - Limit
limitnumber - 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 interval
intervaltextRequired - 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 words
descriptiontext - Words to find in map units' descriptions, such as banded iron or pillow basalt. Give these, a 'Map', or both.
- Map
map_sourcetext - Only units of this geologic map. Pick one, or type the map's ID from 'Find geologic maps'.
- Rock type
lithologytext - 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 scales
scaleslist - 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). - Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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 name
strat_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 interval
intervaltext - 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 type
lithologytext - 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.
- Environment
environmenttext - 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 use
economic_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.
- Latitude
latitudenumber - To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'.From -90 to 90.
- Longitude
longitudenumber - To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'.From -180 to 180.
- Include neighbouring columns
include_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. - Column
columntext - Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
- Project
projecttext - Only columns of this Macrostrat project: a region such as North America or New Zealand, or the offshore drilling sites.
- Order
ordertext - 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. - Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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
- Name
nametextRequired - The name to look for, such as Oneota or Green River.
- Match
matchtext - Names that start with it, contain it, or are exactly it.One of:
starts_with(Starts with),contains,exact(Exactly). Default:starts_with. - Rank
ranktext - Only names of this rank. Leave empty for every rank.One of:
SGp(Supergroup),Gp(Group),SubGp(Subgroup),Fm(Formation),Mbr(Member),Bed. - Time interval
intervaltext - 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.
- Limit
limitnumber - How many to return, from 1 to 100.From 1 to 100. Default:
25. - Page
pagenumber - 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 text
querytextRequired - The start of a name, such as Mancos, Jur or gran.
- Kinds of entry
categorieslist - 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"
}
]
}