--- title: "Get taxon importances by to" method: GET path: "/taxon-observations/{to_code}/taxon-importances" tags: ["Taxon importances"] --- # Get taxon importances by to `GET /taxon-observations/{to_code}/taxon-importances` ## Request - Base URL: `https://api.vegbank.org` - URL: `https://api.vegbank.org/taxon-observations/{to_code}/taxon-importances` - Auth: none required - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a paginated collection of taxon importances associated with the specified taxon observation (using its `to_code`). ## Path parameters - `to_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 [Operation history](https://skmtc.dev/nceas/apis/vegbankapi/changes/taxon-observations/:to_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.dev/nceas/apis/vegbankapi/revisions/852fd165e202?raw)