GET defs/intervals

macrostrat.org:macrostrat-api

Summary: Get time interval definitions
Operation ID: getIntervals
Auth: unknown
Description

Returns all time interval definitions (geologic time periods) from the International Chronostratigraphic Chart.

Parameters (9)

age (number, query, optional)

Numerical age in millions of years before present (Ma)

all (boolean, query, optional)

Return all results

b_age (number, query, optional)

Early age (older bound) in Ma

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']}

int_id (integer, query, optional)

A chronostratigraphic time interval ID from /defs/intervals

interval_name (string, query, optional)

Chronostratigraphic time interval name (e.g., Permian, Cretaceous)

t_age (number, query, optional)

Late age (younger bound) in Ma

timescale (string, query, optional)

A valid timescale name as defined in /defs/timescales

timescale_id (integer, query, optional)

A valid timescale ID

Examples (3)

TitleTypeURLAction
Get all geologic intervals curl https://macrostrat.org/defs/intervals?all=true
Search by interval name (Cretaceous) curl https://macrostrat.org/defs/intervals?interval_name=Cretaceous
Find interval by age (100 Ma) curl https://macrostrat.org/defs/intervals?age=100

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:37:10.051548 404 385ms
2026-03-23 09:38:28.147238 404 390ms
2026-03-23 09:34:13.877026 404 396ms