GET /defs/lithologies

macrostrat.org:macrostrat-api

Summary: Get lithology definitions
Operation ID: getLithologies
Auth: unknown
Description

Returns all lithology definitions (rock types) used in Macrostrat.

Parameters (7)

all (boolean, query, optional)

Return all results

format (string, query, optional)

Desired output format (json, csv, geojson, geojson_bare, topojson, topojson_bare)

Constraints: {'enum': ['json', 'csv', 'geojson', 'geojson_bare', 'topojson', 'topojson_bare']}

lith (string, query, optional)

Specific lithology name (e.g., shale, sandstone, limestone)

lith_class (string, query, optional)

General lithologies (sedimentary, igneous, metamorphic)

lith_group (string, query, optional)

Lithology group

lith_id (integer, query, optional)

ID of a lithology from /defs/lithologies

lith_type (string, query, optional)

Groups of lithologies (e.g., carbonate, siliciclastic)

Examples (3)

TitleTypeURLAction
Get all lithology definitions curl https://macrostrat.org/defs/lithologies?all=true
Filter by lithology name curl https://macrostrat.org/defs/lithologies?lith=sandstone
Filter by lithology class and type curl https://macrostrat.org/defs/lithologies?lith_class=sedimentary&lith_type=clastic

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:49:03.333595 404 389ms
2026-03-23 10:41:41.460628 404 402ms
2026-03-23 10:11:24.282948 404 388ms