# Macrostrat

> 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.

App · 17 actions. Web page: https://docs.lodol.com/docs/integrations/macrostrat

## Actions

### 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 (`latitude`, number): To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'. From -90 to 90.
- Longitude (`longitude`, number): To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'. From -180 to 180.
- Map scales (`scales`, list): 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 (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `maps` (list): The maps, the most detailed first.
- `more_available` (true/false): True when there is a next page.
- `page` (number): Which page this is, from 1.
- `total` (number): How many matched.

**Example output**

```json
{
  "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 (`latitude`, number): To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'. From -90 to 90.
- Longitude (`longitude`, number): To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'. From -180 to 180.
- Include neighbouring columns (`include_adjacent`, true/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_name`, text): 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 (`interval`, text): 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_ma`, number): 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_ma`, number): 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_ma`, number): 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 (`lithology`, text): 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 (`environment`, text): 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_use`, text): 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 (`project`, text): Only columns of this Macrostrat project: a region such as North America or New Zealand, or the offshore drilling sites.
- Limit (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `columns` (list): The columns, as Macrostrat lists them.
- `count` (number): How many are in this answer.
- `more_available` (true/false): True when there is a next page.
- `page` (number): Which page this is, from 1.
- `total` (number): How many matched.

**Example output**

```json
{
  "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_ma`, number): 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_ma`, number): 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_ma`, number): 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 (`match`, text): 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 (`timescale`, text): 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 (`limit`, number): How many to return, from 1 to 500. From 1 to 500. Default: `100`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `intervals` (list): The intervals, broadest kind first (eons, eras, periods, epochs, ages), each kind youngest first.
- `more_available` (true/false): True when more matched than the limit.
- `total` (number): How many intervals matched.

**Example output**

```json
{
  "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 (`column`, text, required): The column's ID, which 'Find stratigraphic columns' and every rock unit give.

**Outputs**

- `age` (text): The age as words and numbers, oldest first, such as 'Paibian to Tremadocian, 497 to 477.1 Ma' (Ma: millions of years ago).
- `area_km2` (number): The area the column stands for, in square kilometres.
- `attribution` (text): 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_id` (number): The column's ID. 'Get a column' and the 'Column' fields take it.
- `column_type` (text): 'column' for a region, 'section' for one measured section.
- `column_url` (text): The column's page on Macrostrat.
- `economic_uses` (list): What the rock is used for or holds, such as an aquifer, coal or oil.
- `environments` (list): The environments the rock formed in, the largest share first.
- `fossil_collections` (number): How many Paleobiology Database fossil collections come from it.
- `found` (true/false): False when Macrostrat has no column with this ID.
- `group` (text): The group of columns it belongs to, often a geologic province.
- `group_id` (number): That group's ID.
- `latitude` (number): The latitude of the column's centre.
- `lithologies` (list): Each rock type in it, the largest share first.
- `lithology` (text): Its rock types as text, with their shares, such as 'dolomite 83%, quartz arenite 17%'.
- `longitude` (number): The longitude of the column's centre.
- `max_thickness_m` (number): The greatest thickness of its rocks, in metres.
- `name` (text): The column's name, such as 'Baraboo District, Sauk County, Wisconsin'.
- `oldest_age_ma` (number): When it begins: its oldest age, in millions of years ago (Ma).
- `oldest_interval` (text): The time interval its oldest age falls in, such as 'Paibian'.
- `project` (text): That project's name.
- `project_id` (number): The project it belongs to, such as 1 (North America).
- `references` (list): The publications the column is compiled from.
- `section_count` (number): How many sections (gap-bound packages) it has.
- `status` (text): 'active', 'in process' or 'obsolete'.
- `unit_count` (number): How many rock units it has.
- `units` (list): Its rock units, from the top (youngest) down.
- `youngest_age_ma` (number): When it ends: its youngest age, in millions of years ago (Ma).
- `youngest_interval` (text): The time interval its youngest age falls in, such as 'Tremadocian'.

**Example output**

```json
{
  "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 (`unit`, text, required): The rock unit's ID, which 'Search rock units', 'Get a column' and the point and map unit actions give.

**Outputs**

- `age` (text): The age as words and numbers, oldest first, such as 'Paibian to Tremadocian, 497 to 477.1 Ma' (Ma: millions of years ago).
- `attribution` (text): 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.
- `citations` (list): Those references as citation lines.
- `color` (text): The color Macrostrat draws it in, as a hex code.
- `column_id` (number): The column it is in. 'Get a column' takes it.
- `column_url` (text): Its column's page on Macrostrat.
- `economic_uses` (list): What the rock is used for or holds, such as an aquifer, coal or oil.
- `environments` (list): The environments the rock formed in, the largest share first.
- `formation` (text): The formation it is, or is in.
- `fossil_collections` (number): How many Paleobiology Database fossil collections come from it.
- `fossil_occurrences` (number): How many fossil occurrences those hold.
- `found` (true/false): False when Macrostrat has no rock unit with this ID.
- `group` (text): The group it is in.
- `latitude` (number): The latitude of its column's centre.
- `lithologies` (list): Each rock type in it, the largest share first.
- `lithology` (text): Its rock types as text, with their shares, such as 'dolomite 83%, quartz arenite 17%'.
- `longitude` (number): The longitude of its column's centre.
- `max_thickness_m` (number): Its greatest thickness, in metres.
- `measurement_types` (list): The kinds of measurement held for it, such as 'geochemical minor elements'. 'List measurements' lists them.
- `member` (text): The member it is, or is in.
- `min_thickness_m` (number): Its least thickness, in metres (0 can mean not known).
- `name` (text): The unit's name, such as 'Mancos Shale Fm'.
- `notes` (text): Macrostrat's notes on the unit.
- `oldest_age_ma` (number): When it begins: its oldest age, in millions of years ago (Ma).
- `oldest_interval` (text): The time interval its oldest age falls in, such as 'Paibian'.
- `outcrop` (text): Where it is found: 'outcrop', 'subsurface' or 'both'.
- `paleo_latitude_bottom` (number): Where its column was when the unit's bottom formed: the latitude then.
- `paleo_latitude_top` (number): Where its column was when the unit's top formed: the latitude then.
- `paleo_longitude_bottom` (number): The longitude then.
- `paleo_longitude_top` (number): The longitude then.
- `project_id` (number): The project its column belongs to.
- `reference_ids` (list): The references the unit is compiled from.
- `section_id` (number): The section (package) of the column it is in.
- `strat_name` (text): Its full stratigraphic name, such as 'Mancos Shale'.
- `strat_name_id` (number): Its stratigraphic name's ID. 'Get a stratigraphic name' takes it.
- `supergroup` (text): The supergroup it is in.
- `unit_id` (number): The rock unit's ID. 'Get a rock unit' takes it.
- `units_above` (list): The units resting on top of it.
- `units_below` (list): The units under it.
- `youngest_age_ma` (number): When it ends: its youngest age, in millions of years ago (Ma).
- `youngest_interval` (text): The time interval its youngest age falls in, such as 'Tremadocian'.

**Example output**

```json
{
  "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 (`concept`, text, required): The concept's ID, which every stratigraphic name gives, or its exact name.

**Outputs**

- `attribution` (text): 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.
- `author` (text): Who wrote the entry, such as the USGS Geolex.
- `citations` (list): The references for the entry, as citation lines.
- `concept_id` (number): The concept's ID.
- `found` (true/false): False when Macrostrat has no such concept.
- `geologic_age` (text): Its age in the lexicon's words.
- `interval` (text): The time interval it is assigned to.
- `lexicon_url` (text): The entry in its source lexicon, such as Geolex.
- `macrostrat_url` (text): The concept's page in Macrostrat's lexicon.
- `name` (text): The concept's name, such as 'Mancos'.
- `names` (list): The stratigraphic names in the concept.
- `notes` (text): Other notes, such as where the name comes from and its type section.
- `oldest_interval` (text): The time interval it begins in.
- `provinces` (list): The geologic provinces and basins it is found in.
- `usage_notes` (text): Notes on how the name is used.
- `youngest_interval` (text): The time interval it ends in.

**Example output**

```json
{
  "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_name`, text, required): The name's ID, which 'Search stratigraphic names' and every rock unit give.

**Outputs**

- `attribution` (text): 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.
- `bed` (text): The bed, when it is one.
- `bed_id` (number): That bed's name ID.
- `citation` (text): That reference as a citation line.
- `concept_id` (number): Its concept, which joins names for the same rocks. 'Get a stratigraphic concept' takes it.
- `formation` (text): The formation it is, or is in.
- `formation_id` (number): That formation's name ID.
- `found` (true/false): False when Macrostrat has no name with this ID.
- `full_name` (text): The name with its rank, such as 'Oneota Formation'.
- `group` (text): The group it is, or is in.
- `group_id` (number): That group's name ID.
- `hierarchy` (list): Every name in its hierarchy, largest rank first: its group, the formations in it, their members and beds.
- `interval` (text): The time interval it is assigned to, when one is.
- `macrostrat_url` (text): The name's page in Macrostrat's lexicon.
- `member` (text): The member it is, or is in.
- `member_id` (number): That member's name ID.
- `name` (text): The name, such as 'Oneota'.
- `oldest_age_ma` (number): When it begins: its oldest age, in millions of years ago (Ma).
- `oldest_period` (text): The geologic period its oldest age falls in.
- `rank` (text): Its rank: SGp, Gp, SubGp, Fm, Mbr or Bed.
- `rank_name` (text): Its rank in words: Supergroup, Group, Formation and so on.
- `ref_id` (number): The reference the name comes from.
- `strat_name_id` (number): The name's ID. 'Get a stratigraphic name' takes it.
- `subgroup` (text): The subgroup it is in.
- `subgroup_id` (number): That subgroup's name ID.
- `supergroup` (text): The supergroup it is in.
- `supergroup_id` (number): That supergroup's name ID.
- `unit_count` (number): How many Macrostrat rock units carry the name.
- `youngest_age_ma` (number): When it ends: its youngest age, in millions of years ago (Ma).
- `youngest_period` (text): The geologic period its youngest age falls in.

**Example output**

```json
{
  "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 (`latitude`, number, required): The point's latitude in decimal degrees, from -90 (south) to 90 (north). From -90 to 90.
- Longitude (`longitude`, number, required): The point's longitude in decimal degrees, from -180 (west) to 180 (east). From -180 to 180.
- Map detail (`map_detail`, text): 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**

- `age` (text): The age as words and numbers, oldest first, such as 'Paibian to Tremadocian, 497 to 477.1 Ma' (Ma: millions of years ago).
- `attribution` (text): 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.
- `color` (text): The color the map shows it in, as a hex code.
- `comments` (text): The map's notes on it.
- `description` (text): The map's description of the rock.
- `elevation_m` (number): The ground's height there in metres, below zero under the sea.
- `found` (true/false): True when a geologic map covers the point. Open ocean is often not mapped.
- `latitude` (number): The point's latitude.
- `line` (object): A fault or other line mapped at or right by the point.
- `lithology` (text): The rock types as the map writes them.
- `lithology_ids` (list): The IDs of its rock types.
- `longitude` (number): The point's longitude.
- `macrostrat_unit_ids` (list): The Macrostrat rock units matched to it. 'Get a rock unit' takes each.
- `map_id` (number): The map polygon's ID in Macrostrat.
- `map_url` (text): The point on Macrostrat's map, to open in a browser.
- `name` (text): The map unit's name, such as 'Wonewoc Formation (Cw)'.
- `oldest_age_ma` (number): When it begins: its oldest age, in millions of years ago (Ma).
- `oldest_interval` (text): The time interval its oldest age falls in, such as 'Paibian'.
- `scale` (text): How detailed the map is: large (local), medium (regional), small (continental) or tiny (global).
- `source` (object): The geologic map this comes from, with its citation.
- `source_id` (number): The ID of the map it is from.
- `strat_name` (text): The stratigraphic names the map gives it, such as 'Shakopee Formation; Oneota Formation'.
- `strat_name_ids` (list): The stratigraphic names matched to it. 'Get a stratigraphic name' takes each.
- `units_summary` (object): What Macrostrat's rock units matched to this map unit say about it.
- `youngest_age_ma` (number): When it ends: its youngest age, in millions of years ago (Ma).
- `youngest_interval` (text): The time interval its youngest age falls in, such as 'Tremadocian'.

**Example output**

```json
{
  "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 (`unit`, text): Only those of this rock unit, by its ID from 'Search rock units'.
- Column (`column`, text): 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_id`, text): Only collections from rocks of this stratigraphic name, by its ID from 'Search stratigraphic names'.
- Time interval (`interval`, text): 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_ma`, number): Only collections from rocks of this age, in millions of years ago, such as 271. From 0 to 4600.0.
- Limit (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `collections` (list): The fossil collections, youngest first.
- `count` (number): How many are in this answer.
- `more_available` (true/false): True when there is a next page.
- `page` (number): Which page this is, from 1.
- `references` (list): The publications the results cite, by the reference ID each result names.
- `total` (number): How many matched.

**Example output**

```json
{
  "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 (`latitude`, number, required): The point's latitude in decimal degrees, from -90 (south) to 90 (north). From -90 to 90.
- Longitude (`longitude`, number, required): The point's longitude in decimal degrees, from -180 (west) to 180 (east). From -180 to 180.
- Map scales (`scales`, list): 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**

- `attribution` (text): 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.
- `count` (number): How many map units cover the point.
- `latitude` (number): The point's latitude.
- `longitude` (number): The point's longitude.
- `map_url` (text): The point on Macrostrat's map.
- `sources` (list): The publications the results cite, by the reference ID each result names.
- `units` (list): Every map unit at the point, the most detailed map first.

**Example output**

```json
{
  "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 (`unit`, text): Only those of this rock unit, by its ID from 'Search rock units'.
- Column (`column`, text): Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
- Measurement (`measurement`, text): Only this kind of measurement, such as Ba or 238U-206Pb. Give this, a 'Rock unit' or a 'Column'.
- Kind of measurement (`measurement_type`, text): 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 (`interval`, text): 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 (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `measurements` (list): The measurements, one row per sample and kind.
- `more_available` (true/false): True when there is a next page.
- `page` (number): Which page this is, from 1.
- `references` (list): The publications the results cite, by the reference ID each result names.
- `total` (number): How many matched.

**Example output**

```json
{
  "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 (`name`, text): A mineral's name, such as quartz, or its start, such as quar. Give this, a 'Mineral group', or both.
- Mineral group (`mineral_type`, text): Only minerals of this group. One of: `aluminosilicate`, `amphibole`, `carbonate`, `chlorite`, `clinopyroxene`, `cyclosilicate`, `element`, `feldspar`, `garnet`, `inosilicate`, and 8 more.
- Limit (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `minerals` (list): The minerals, an exact name first, then in order of name.
- `more_available` (true/false): True when more matched than the limit.
- `total` (number): How many minerals matched.

**Example output**

```json
{
  "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 (`interval`, text, required): The interval to look up. Pick one from the international time scale, or type any interval's name or ID.

**Outputs**

- `abbreviation` (text): Its abbreviation, such as 'P'.
- `attribution` (text): 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.
- `color` (text): Its standard color on time scale charts, as a hex code.
- `duration_myr` (number): How long it lasted, in millions of years.
- `found` (true/false): False when no interval has exactly this name; 'other_matches' then lists those whose names hold it.
- `int_id` (number): The interval's ID. 'Look up a time interval' takes it.
- `macrostrat_url` (text): The interval's page in Macrostrat's lexicon.
- `name` (text): The interval's name, such as 'Permian'.
- `oldest_age_ma` (number): When it begins, in millions of years ago (Ma).
- `other_matches` (list): Other intervals whose names hold the text, such as 'Late Permian'.
- `part_of` (list): The international eon, era, period and epoch it falls in, broadest first.
- `timescales` (list): The timescales it belongs to.
- `type` (text): What kind of interval it is: eon, era, period, epoch, age, zone...
- `youngest_age_ma` (number): When it ends, in millions of years ago (Ma).

**Example output**

```json
{
  "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 (`description`, text): Words to find in map units' descriptions, such as banded iron or pillow basalt. Give these, a 'Map', or both.
- Map (`map_source`, text): Only units of this geologic map. Pick one, or type the map's ID from 'Find geologic maps'.
- Rock type (`lithology`, text): 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 (`scales`, list): 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 (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `more_available` (true/false): True when there is a next page.
- `page` (number): Which page this is, from 1.
- `sources` (list): The publications the results cite, by the reference ID each result names.
- `total` (number): How many matched.
- `units` (list): The map units, the largest area first.

**Example output**

```json
{
  "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_name`, text): 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 (`interval`, text): 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_ma`, number): 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_ma`, number): 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_ma`, number): 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 (`lithology`, text): 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 (`environment`, text): 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_use`, text): 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 (`latitude`, number): To search at a place: its latitude in decimal degrees, from -90 to 90, with 'Longitude'. From -90 to 90.
- Longitude (`longitude`, number): To search at a place: its longitude in decimal degrees, from -180 to 180, with 'Latitude'. From -180 to 180.
- Include neighbouring columns (`include_adjacent`, true/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 (`column`, text): Only those of this column, by its ID from 'Find stratigraphic columns'. On its own, lists a column's rock units top down.
- Project (`project`, text): Only columns of this Macrostrat project: a region such as North America or New Zealand, or the offshore drilling sites.
- Order (`order`, text): 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 (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `more_available` (true/false): True when there is a next page.
- `page` (number): Which page this is, from 1.
- `references` (list): The publications the results cite, by the reference ID each result names.
- `total` (number): How many matched.
- `units` (list): The rock units, in the order chosen.

**Example output**

```json
{
  "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 (`name`, text, required): The name to look for, such as Oneota or Green River.
- Match (`match`, text): Names that start with it, contain it, or are exactly it. One of: `starts_with` (Starts with), `contains`, `exact` (Exactly). Default: `starts_with`.
- Rank (`rank`, text): 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 (`interval`, text): 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 (`limit`, number): How many to return, from 1 to 100. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 1000. Default: `1`.

**Outputs**

- `attribution` (text): 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.
- `count` (number): How many are in this answer.
- `more_available` (true/false): True when there is a next page.
- `names` (list): The names, those carried by the most rock units first.
- `page` (number): Which page this is, from 1.
- `total` (number): How many matched.

**Example output**

```json
{
  "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 (`query`, text, required): The start of a name, such as Mancos, Jur or gran.
- Kinds of entry (`categories`, list): 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**

- `attribution` (text): 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.
- `count` (number): How many entries matched (at most 100).
- `matches` (list): The entries whose names start with the text, by kind.

**Example output**

```json
{
  "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"
    }
  ]
}
```
