{
  "success": {
    "v": 2,
    "license": "CC-BY 4.0",
    "description": "all Macrostrat units matching search criteria",
    "options": {
      "parameters": {
        "unit_id": "integer, a valid unit id",
        "section_id": "integer, a valid section id",
        "col_id": "integer, a valid column id",
        "col_type": "string, a column type",
        "interval_name": "string, chronostratigraphic time interval name",
        "int_id": "integer, a chronostratigraphic time interval ID from /defs/intervals",
        "age": "numerical age in millions of years before present",
        "age_top": "numerical age (Ma) - must be used with age_bottom and be less than age_bottom",
        "age_bottom": "numerical age (Ma) - must be used with age_top and be greater than age_top",
        "lith_id": "integer, ID of a lithology from /defs/lithologies",
        "lith": "string, specific lithology name (e.g., shale, sandstone)",
        "lith_type": "string, groups of lithologies (e.g., carbonate, siliciclastic)",
        "lith_class": "string, general lithologies (sedimentary, igneous, metamorphic)",
        "lith_att_id": "integer, ID of a lithology attribute from /defs/lithology_attributes",
        "lith_att": "string, specific lithology attribute name (e.g. fine, olivine, poorly washed)",
        "lith_att_type": "string, specific category of lithology attribute (e.g. grains, lithology, bedform)",
        "environ_id": "integer, specific environment ID from /defs/environments",
        "environ": "string, specific environment",
        "environ_type": "string, groups of environments",
        "environ_class": "string, general environments",
        "econ_id": "integer, ID of an economic attribute from /defs/econs",
        "econ": "string, name of an economic attribute",
        "econ_type": "string, name of an economic attribute type",
        "econ_class": "string, name of an economic attribute class",
        "cltn_id": "integer, one or more Paleobiology Database collection IDs",
        "strat_name": "a fuzzy stratigraphic name to match units to",
        "strat_name_id": "integer, a single or comma-separated list of stratigraphic IDs from /defs/strat_names",
        "strat_name_concept_id": "integer, a single or comma-separated list of stratigraphic name concept IDs from /defs/strat_name_concepts",
        "lat": "number, decimal degree latitude, WGS84",
        "lng": "number, decimal degree longitude, WGS84",
        "adjacents": "boolean, if lat/lng or col_id is specified, optionally return all units in columns that touch the polygon containing the supplied lat/lng",
        "project_id": "a Macrostrat project ID",
        "status_code": "string, column status codes, values 'active','in process','obsolete'. Defaults to 'active'",
        "response": "Any available response_type. Default is short.",
        "format": "string, desired output format",
        "geom_age": "If requesting a geographic format, specifies which age to use for the primary coordinates. Accepted parameters are 'modern' (clat, clng), 'top' (t_plat, t_plng) and 'bottom' (b_plat, b_plng). Default is 'modern'",
        "summarize_measures": "If present, returns summary statistics about the measurements associated with each unit",
        "show_position": "If present, return the unit top and bottom position in section",
        "sample": "Return a sample of units"
      },
      "output_formats": [
        "json",
        "csv",
        "geojson",
        "topojson",
        "geojson_bare",
        "topojson_bare"
      ],
      "examples": [
        "api/units?section_id=107&format=csv",
        "api/units?interval_name=Permian",
        "api/units?age=271",
        "api/units?interval_name=Permian&response=long",
        "api/units?strat_id=1205,4260",
        "api/units?strat_name=mancos",
        "api/units?strat_name_id=1205&format=geojson_bare&geom_age=bottom"
      ],
      "response_types": [
        "short",
        "long"
      ],
      "fields": {
        "unit_id": "integer, unique identifier for unit",
        "section_id": "integer, unique identifier for section (package)",
        "col_id": "integer, unique identifier for column",
        "project_id": "unique identifier for project, corresponds to general geographic region",
        "col_area": "float, area in square kilometers of the Macrostrat column",
        "unit_name": "text, the name of the unit",
        "strat_name_id": "integer, unique identifier for known stratigraphic name(s) (see /defs/strat_names)",
        "Mbr": "text, lithostratigraphic member",
        "Fm": "text, lithostratigraphic formation",
        "Gp": "text, lithostratigraphic group",
        "SGp": "text, lithostratigraphic supergroup",
        "t_age": "number, continuous time age model estimated for truncation, in Myr before present",
        "b_age": "number, continuous time age model estimated for initiation, in Myr before present",
        "max_thick": "number, maximum unit thickness in meters",
        "min_thick": "number, minimum unit thickess in meters (NB: some zero values may be equivalent in meaning to NULL)",
        "outcrop": "text, describes where unit is exposed or not, values are  'outcrop', 'subsurface', or 'both'",
        "pbdb_collections": "integer, count of PBDB collections in units/column",
        "pbdb_occurrences": "integer, count of PBDB occurrences in units/column",
        "lith": "text, specific lithology, see /defs/lithologies",
        "environ": "text, specific environment, see /defs/environments",
        "econ": "text, name of econonomic use, see defs/econs",
        "measure": "array, summary of types of measurements available",
        "notes": "text, notes releavnt to containing element",
        "color": "text, recommended coloring for units based on dominant lithology",
        "text_color": "text, recommended coloring for text based on color",
        "t_int_id": "integer, the ID of the chronostratigraphic interval containing the top boundary of the unit",
        "t_int_name": "text, the name of the chronostratigraphic interval containing the top boundary of the unit",
        "t_int_age": "float, the top age of the chronostratigraphic interval containing the top boundary of the unit",
        "t_prop": "decimal, position of continuous time age model top boundary, proportional to reference time interval (t_interval)",
        "units_above": "array of integers, the unit_ids of the units contacting the top of the unit",
        "b_int_id": "integer, the ID of the chronostratigraphic interval containing the bottom boundary of the unit",
        "b_int_name": "text, the name of the chronostratigraphic interval containing the bottom boundary of the unit",
        "b_int_age": "float, the bottom age of the chronostratigraphic interval containing the bottom boundary of the unit",
        "b_prop": "decimal, position of continuous time age model bottom boundary, proportional to reference time interval (b_interval)",
        "units_below": "array of integers, the unit_ids of the units contacting the bottom of the unit",
        "clat": "number, present day latitude of of the centroid of the column to which the unit belongs",
        "clng": "number, present day longitude of of the centroid of the column to which the unit belongs",
        "t_plat": "number, same as clat, but rotated to the t_age. Top age paleo latitude.",
        "t_plng": "number, same as clng, but rotated to the t_age. Top age paleo longitude.",
        "b_plat": "number, same as clat, but rotated to the b_age. Bottom age paleo latitude.",
        "b_plng": "number, same as clng, but rotated to the b_age. Bottom age paleo latitude.",
        "t_pos": "The position of unit top in ordering of units in section, optionally in units of m for some columns (e.g., eODP project)",
        "b_pos": "The position of unit bottom in ordering of units in section, optionally in units of m for some columns (e.g., eODP project)"
      }
    }
  }
}