--- title: "Get taxon importances by ob" method: GET path: "/plot-observations/{ob_code}/taxon-importances" tags: ["Taxon importances"] --- # Get taxon importances by ob `GET /plot-observations/{ob_code}/taxon-importances` Retrieve a paginated collection of taxon importances associated with the specified plot observation (using its `ob_code`). ## Path parameters - `ob_code` string, required ## Query parameters - `detail` 'minimal' | 'full' - `with_nested` boolean - `limit` integer - `offset` integer - `create_parquet` boolean ## Response `200` Matching taxon importances(s), with fields based on parameters: - `detail=minimal&with_nested=false`: Basic fields only - `detail=minimal&with_nested=true`: Basic fields + nested array fields - `detail=full&with_nested=false`: Extended fields, no nested array fields - `detail=full&with_nested=true`: Extended fields + nested array fields - union - TaxonImpMinimal - `count` integer — Total matching record count - `data` TaxonImpMinimal[] — Data records - TaxonImpMinimalNested - `count` integer — Total matching record count - `data` object[] — Data records - `tm_code` string — VegBank taxon importance identifier - `to_code` string — VegBank taxon observation identifier - `ob_code` string — VegBank plot observation identifier - `sr_code` string — VegBank stratum identifier - `cover` number, float — Cover, in percent, of the taxon (limited to one stratum if sr_code has a value) - `cover_code` string — Original cover code used by the author in the Cover Method for the plot - `basal_area` number, float — Total basal area of the species in m2/ha (limited to one stratum if sr_code has a value) - `biomass` number, float — Biomass of the species in g/m2 (limited to one stratum if sr_code has a value) - `inference_area` number, float — Area used to infer the importance values of the taxon, if not the same as plot-observation taxon_inference_area - `stratum_base` number, float — Base of the stratum, in meters - `stratum_height` number, float — Tallest part of the stratum, in meters - `stems` object[] — Stem count records - `sc_code` string — VegBank stem count record identifier - `diameter` number, float — Diameter of the stem in centimeters. When diameter classes are used, the diameter is the midpoint between the low end and high end for the diameter class; the offset between this and the endpoints is stored in stem_diameter_accuracy. - `diameter_accuracy` number, float — Accuracy of the stem diameter measurements in centimeters, representing the distance between the diameter class midpoint and endpoint - `height` number, float — Measured height of the stem in meters. When height classes are used, the height is the midpoint between the low end and high end for the height class; the offset between this and the endpoint is stored in stem_height_accuracy. - `height_accuracy` number, float — Accuracy of the measured height of a stem, representing the offset between the midpoint of the class and the endpoint, in meters. - `count` integer — Number of stems of a single species that have these specific stem diameter and height data in common - `taxon_area` number, float — Area in m2 used to infer the presence of the stem(s) referenced in this record. Overrides similar area field in taxon observation, taxon importance, and/or plot observation. RESERVED VALUE: -1 is used to indicate no known boundaries were used while collecting this stem size. - TaxonImpFull - `count` integer — Total matching record count - `data` object[] — Data records - `tm_code` string — VegBank taxon importance identifier - `to_code` string — VegBank taxon observation identifier - `ob_code` string — VegBank plot observation identifier - `sr_code` string — VegBank stratum identifier - `cover` number, float — Cover, in percent, of the taxon (limited to one stratum if sr_code has a value) - `cover_code` string — Original cover code used by the author in the Cover Method for the plot - `basal_area` number, float — Total basal area of the species in m2/ha (limited to one stratum if sr_code has a value) - `biomass` number, float — Biomass of the species in g/m2 (limited to one stratum if sr_code has a value) - `inference_area` number, float — Area used to infer the importance values of the taxon, if not the same as plot-observation taxon_inference_area - `stratum_base` number, float — Base of the stratum, in meters - `stratum_height` number, float — Tallest part of the stratum, in meters - `author_obs_code` string — Code or name provided by the author to identify the classified plot observation - `author_plant_name` string — Name provided by the plot author to refer to a taxon observed within the plot - `stratum_name` string — Name associated with stratum by the stratum method - TaxonImpFullNested - `count` integer — Total matching record count - `data` object[] — Data records - `tm_code` string — VegBank taxon importance identifier - `to_code` string — VegBank taxon observation identifier - `ob_code` string — VegBank plot observation identifier - `sr_code` string — VegBank stratum identifier - `cover` number, float — Cover, in percent, of the taxon (limited to one stratum if sr_code has a value) - `cover_code` string — Original cover code used by the author in the Cover Method for the plot - `basal_area` number, float — Total basal area of the species in m2/ha (limited to one stratum if sr_code has a value) - `biomass` number, float — Biomass of the species in g/m2 (limited to one stratum if sr_code has a value) - `inference_area` number, float — Area used to infer the importance values of the taxon, if not the same as plot-observation taxon_inference_area - `stratum_base` number, float — Base of the stratum, in meters - `stratum_height` number, float — Tallest part of the stratum, in meters - `author_obs_code` string — Code or name provided by the author to identify the classified plot observation - `author_plant_name` string — Name provided by the plot author to refer to a taxon observed within the plot - `stratum_name` string — Name associated with stratum by the stratum method - `stems` object[] — Stem count records - `sc_code` string — VegBank stem count record identifier - `diameter` number, float — Diameter of the stem in centimeters. When diameter classes are used, the diameter is the midpoint between the low end and high end for the diameter class; the offset between this and the endpoints is stored in stem_diameter_accuracy. - `diameter_accuracy` number, float — Accuracy of the stem diameter measurements in centimeters, representing the distance between the diameter class midpoint and endpoint - `height` number, float — Measured height of the stem in meters. When height classes are used, the height is the midpoint between the low end and high end for the height class; the offset between this and the endpoint is stored in stem_height_accuracy. - `height_accuracy` number, float — Accuracy of the measured height of a stem, representing the offset between the midpoint of the class and the endpoint, in meters. - `count` integer — Number of stems of a single species that have these specific stem diameter and height data in common - `taxon_area` number, float — Area in m2 used to infer the presence of the stem(s) referenced in this record. Overrides similar area field in taxon observation, taxon importance, and/or plot observation. RESERVED VALUE: -1 is used to indicate no known boundaries were used while collecting this stem size. ## Other responses - `400` — Invalid Parameters ## Changes > 50 revisions in range; 1 not diffed. - **2026-03-16** `c37c8d7a84c5` — 1 breaking, 22 warning, 8 info - added `#/components/schemas/taxon_imp_minimal, #/components/schemas/taxon_imp_minimal_nested` to the response body `oneOf` list for the response status `200` - removed the optional property `oneOf[#/components/schemas/taxon_imp_full]/allOf[subschema #2]/data/items/allOf[#/components/schemas/TaxonImpFull]/basal_area` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/taxon_imp_full]/allOf[subschema #2]/data/items/allOf[#/components/schemas/TaxonImpFull]/biomass` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/taxon_imp_full]/allOf[subschema #2]/data/items/allOf[#/components/schemas/TaxonImpFull]/cover` from the response with the `200` status - …27 more - **2026-03-04** `31e82224728b` — 2 info - added `#/components/schemas/record_count, subschema #2` to the `oneOf[#/components/schemas/taxon_imp_full]/` response property `allOf` list for the response status `200` - added `#/components/schemas/record_count, subschema #2` to the `oneOf[#/components/schemas/taxon_imp_full_nested]/` response property `allOf` list for the response status `200` - …earlier changes not shown [Full history](https://skmtc.dev/nceas/apis/vegbankapi/changes/plot-observations/:ob_code/taxon-importances/get.md) --- [API](https://skmtc.dev/nceas/apis/vegbankapi.md) · [All operations](https://skmtc.dev/nceas/apis/vegbankapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nceas/vegbankapi/revisions/852fd165e202/schema)