---
title: "Get taxon importances by pc"
method: GET
path: "/plant-concepts/{pc_code}/taxon-importances"
tags: ["Taxon importances"]
---

# Get taxon importances by pc

`GET /plant-concepts/{pc_code}/taxon-importances`

Retrieve a paginated collection of taxon importances interpreted to the specified plant concept (using its `pc_code`).

## Path parameters

- `pc_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

---

[API](https://skmtc.net/nceas/apis/vegbankapi.md) · [All operations](https://skmtc.net/nceas/apis/vegbankapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nceas/vegbankapi/versions/852fd165e202/schema)