---
title: "Get taxon observations by ob"
method: GET
path: "/plot-observations/{ob_code}/taxon-observations"
tags: ["Taxon observations"]
---

# Get taxon observations by ob

`GET /plot-observations/{ob_code}/taxon-observations`

Retrieve a paginated collection of taxon observations 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 observation(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
  - TaxonObsMinimal
    - `count` integer — Total matching record count
    - `data` TaxonObsMinimal[] — Data records
  - TaxonObsMinimalNested
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `to_code` string — VegBank taxon observation identifier
      - `ob_code` string — VegBank plot observation identifier
      - `int_curr_pc_code` string — VegBank identifier for the current interpreted plant concept
      - `int_orig_pc_code` string — VegBank identifier for the original interpreted plant concept
      - `taxon_inference_area` number, float — Area in m2 used to infer the presence of a given taxon. Generally this should be equal to the plot-observation taxon_inference_area, but at times this area may be larger or smaller for a specific taxon. RESERVED VALUE: -1 is used to indicate that no known plot boundaries were used when recording this species on the plot. That is, this species may occur outside the plot area as indicated in the plot and observation tables.
      - `rf_code` string — VegBank identifier for the reference serving as the authority for the taxon used by the plot author; if the authority is unknown, the author of the plot is the authority
      - `taxon_importance` object[] — Extended details about taxon importance
        - `tm_code` string — VegBank taxon importance identifier
        - `sr_code` string — VegBank identifier for the specific stratum to which this taxon importance record applies; if null, this record speaks to the importance of the taxon across all strata
        - `stratum_name` string — Name of the specific stratum to which this taxon importance record applies; if '<All>', this record speaks to the importance of the taxon across all strata
        - `cover` number, float — Cover, in percent, of the taxon (potentially limited to one stratum if sr_cide has a value)
        - `cover_code` string — The 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 (potentially limited to one stratum if sr_code has a value)
        - `biomass` number, float — biomass of the taxon in g/m2 (potentially limited to one stratum if sr_cide has a value)
        - `inference_area` number, float — Area in m2 used to infer the importance values (i.e. cover, biomass, basal area) in this record; RESERVED VALUE: -1 is used to indicate no plot boundaries were used when estimating importance values
        - `stratum_base` number, float — Base of the stratum in meters.
        - `stratum_height` number, float — Tallest part of the Stratum in meters.
  - TaxonObsFull
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `to_code` string — VegBank taxon observation identifier
      - `ob_code` string — VegBank plot observation identifier
      - `int_curr_pc_code` string — VegBank identifier for the current interpreted plant concept
      - `int_orig_pc_code` string — VegBank identifier for the original interpreted plant concept
      - `taxon_inference_area` number, float — Area in m2 used to infer the presence of a given taxon. Generally this should be equal to the plot-observation taxon_inference_area, but at times this area may be larger or smaller for a specific taxon. RESERVED VALUE: -1 is used to indicate that no known plot boundaries were used when recording this species on the plot. That is, this species may occur outside the plot area as indicated in the plot and observation tables.
      - `rf_code` string — VegBank identifier for the reference serving as the authority for the taxon used by the plot author; if the authority is unknown, the author of the plot is the authority
      - `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
      - `int_curr_plant_code` string — Plant code for the current interpreted plant concept
      - `int_curr_plant_common` string — Common name for the current interpreted plant concept
      - `int_curr_plant_sci_full` string — Scientific name (with authors) for the current interpreted plant concept
      - `int_curr_plant_sci_name_no_auth` string — Scientific name (without authors) for the current interpreted plant concept
      - `int_orig_plant_code` string — Plant code for the original interpreted plant concept
      - `int_orig_plant_common` string — Common name for the original interpreted plant concept
      - `int_orig_plant_sci_full` string — Scientific name (with authors) for the original interpreted plant concept
      - `int_orig_plant_sci_name_no_auth` string — Scientific name (without authors) for the original interpreted plant concept
      - `rf_label` string — Name/label of the reference serving as the authority for the taxon used by the plot author; if the authority is unknown, the author of the plot is the authority
  - TaxonObsFullNested
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `to_code` string — VegBank taxon observation identifier
      - `ob_code` string — VegBank plot observation identifier
      - `int_curr_pc_code` string — VegBank identifier for the current interpreted plant concept
      - `int_orig_pc_code` string — VegBank identifier for the original interpreted plant concept
      - `taxon_inference_area` number, float — Area in m2 used to infer the presence of a given taxon. Generally this should be equal to the plot-observation taxon_inference_area, but at times this area may be larger or smaller for a specific taxon. RESERVED VALUE: -1 is used to indicate that no known plot boundaries were used when recording this species on the plot. That is, this species may occur outside the plot area as indicated in the plot and observation tables.
      - `rf_code` string — VegBank identifier for the reference serving as the authority for the taxon used by the plot author; if the authority is unknown, the author of the plot is the authority
      - `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
      - `int_curr_plant_code` string — Plant code for the current interpreted plant concept
      - `int_curr_plant_common` string — Common name for the current interpreted plant concept
      - `int_curr_plant_sci_full` string — Scientific name (with authors) for the current interpreted plant concept
      - `int_curr_plant_sci_name_no_auth` string — Scientific name (without authors) for the current interpreted plant concept
      - `int_orig_plant_code` string — Plant code for the original interpreted plant concept
      - `int_orig_plant_common` string — Common name for the original interpreted plant concept
      - `int_orig_plant_sci_full` string — Scientific name (with authors) for the original interpreted plant concept
      - `int_orig_plant_sci_name_no_auth` string — Scientific name (without authors) for the original interpreted plant concept
      - `rf_label` string — Name/label of the reference serving as the authority for the taxon used by the plot author; if the authority is unknown, the author of the plot is the authority
      - `taxon_importance` object[] — Extended details about taxon importance
        - `tm_code` string — VegBank taxon importance identifier
        - `sr_code` string — VegBank identifier for the specific stratum to which this taxon importance record applies; if null, this record speaks to the importance of the taxon across all strata
        - `stratum_name` string — Name of the specific stratum to which this taxon importance record applies; if '<All>', this record speaks to the importance of the taxon across all strata
        - `cover` number, float — Cover, in percent, of the taxon (potentially limited to one stratum if sr_cide has a value)
        - `cover_code` string — The 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 (potentially limited to one stratum if sr_code has a value)
        - `biomass` number, float — biomass of the taxon in g/m2 (potentially limited to one stratum if sr_cide has a value)
        - `inference_area` number, float — Area in m2 used to infer the importance values (i.e. cover, biomass, basal area) in this record; RESERVED VALUE: -1 is used to indicate no plot boundaries were used when estimating importance values
        - `stratum_base` number, float — Base of the stratum in meters.
        - `stratum_height` number, float — Tallest part of the Stratum in meters.

## 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/revisions/852fd165e202/schema)