---
title: "returns a specific plot observation via the observation accession code"
method: GET
path: "/plot-observations/{accession_code}"
---

# returns a specific plot observation via the observation accession code

`GET /plot-observations/{accession_code}`

## Path parameters

- `accession_code` string, required

## Query parameters

- `detail` string

## Response `200`

found

- PlotObservation
  - `observation_id` string — Database generated identifier assigned to each unique plot observation.
  - `previous_obs_id` integer — Link to data from the previous observation of this plot.
  - `plot_id` integer — Link to data and metadata that do not change between observations and which are stored in the plot table.
  - `project_id` integer — Link between an observation and the project within which the observation was made
  - `author_obs_code` string — This is the code or name that the author uses to identify this plot observation event. Where a plot has only one observation, this will often equal plot.authorPlotCode.
  - `obs_start_date` string, date — The date of the observation, or the first day if the observation spanned more than one day.
  - `obs_end_date` string, date — If the observation event spanned more than a single day, this is the last day on which observations were made.
  - `date_accuracy` string — Estimated accuracy of the observation date.
  - `date_entered` string, date — Date that the observation was added to VegBank
  - `cover_method_id` integer — Link to the scale used to estimate taxon cover. The database stores estimated cover to the nearest percent, but the conversion details are recovered by reference to the specific scale employed.
  - `cover_dispersion` integer — Were cover values for the total taxon list collected from one contiguous area or dispersed subplots?
  - `auto_taxon_cover` boolean — TRUE indicates that taxonObservation.taxonCover was automatically calculated from the values of all stratumObservation.taxonStratumCover
  - `stratummethod_id` integer — Link to the definitions of strata used in recording taxon-specific values of cover.
  - `method_narrative` string — Additional metadata helpful for understanding how the data were collected during the observation event.
  - `taxon_observation_area` number, float — the total surface area (in m^2) used for cover estimates and for which a complete species list is provided. If subplots were used, this would be the total area of the subplots without interstitial space. RESERVED VALUE: -1 is used to indicate the complete list of species had no known boundaries.
  - `stem_size_limite` number, float — Lower diameter limit in centimeters for inclusion of a tree in the stem count (stemCount).
  - `stem_observation_area` number, float — the total surface area (in m^2) observed for recording woody stem data. RESERVED VALUE: -1 means no known area.
  - `stem_sample_method` string — The method used to obtain basal area or tree stem data (e.g., full census, point quarter, random pairs, Bitterlich, other).
  - `original_data` string — Location where the hard data reside and any access instructions.
  - `effort_level` string — This is the effort spent making the observations as estimated by the party that submitted the data (e.g., Very thorough, Average, Hurried description).
  - `plot_validation_level` integer — Quality of plot as determined by an automated filter system, including values such as (1) sufficient for determining type occurrence, (2) sufficient for inclusion in a classification revision, and (3) fully compliant with recommendations.
  - `floristic_quality` string — Subjective assessment of floristic quality by the party that submitted the plot (e.g., Highest, High, High but incomplete, Moderate, Moderate and incomplete, Low).
  - `bryophyte_quality` string — Subjective assessment of the taxonomic quality of the bryophyte data by the party that submitted the plot (e.g., Highest, High, High but incomplete, Moderate, Moderate and incomplete, Low, Very incomplete, absent).
  - `lichen_quality` string — Subjective assessment of the taxonomic quality of the lichen data by the party that submitted the plot (e.g., Highest, High, High but incomplete, Moderate, Moderate and incomplete, Low, Very incomplete, absent).
  - `observation_narrative` string — Additional unstructured observations useful for understanding the ecological attributes and significance of the plot observations.
  - `landscape_narrative` string — Unstructured observations on the landscape context of the observed plot.
  - `homogeneity` string — How homogeneous was the community (e.g., homogeneous, compositional trend across plot, conspicuous inclusions, irregular mosaic or pattern).
  - `phenologic_aspect` string — Season expression of the community (e.g., typical growing season, vernal, aestival, wet, autumnal, winter, dry, irregular ephemerals present).
  - `representativeness` string — How representative was the plot of the stand?
  - `stand_maturity` string — How mature is the stand. Could be young, mature but even-aged, old-growth, etc.
  - `successional_status` string — Description of the assumed successional status of the plot. This description is of necessity highly subjective.
  - `basal_area` number, float — Total basal area of woody stems (in m²/ha). 0 should be used to indicate that plots have no stems.
  - `hydrologic_regime` string — What is the hydrologic regime, which is a reflection of frequency and duration of flooding? List is taken from Cowardin et al. 1979, 1985.
  - `soil_moisture_regime` string — How moist was the soil at the sampling event?
  - `soil_drainage` string — Identifies the natural drainage conditions of the soil and refers to the frequency and duration of wet periods. The soil drainage classes are defined in terms of (1) actual moisture content (in excess of field moisture capacity) and (2) the extent of the period during which excess water is present in the plant-root zone. Soil drainage class categories conform to the FGDC Soil Geographic Data Standards, September 1997. (http://www.fgdc.gov/standards/documents/standards/soils/soil997.PDF.) Definitions are derived from Grossman et al. (1998) and Sims et al. (1997).
  - `water_salinity` string — How saline is the water, if a flooded community?
  - `water_depth` number, float — For aquatic or marine vegetation, what was the water depth in m.
  - `shore_distance` number, float — For aquatic or marine vegetation, what was the closest distance to shore in m.
  - `soil_depth` number, float — Median depth to bedrock or permafrost in m (usually from averaging multiple probe readings).
  - `organic_depth` number, float — Depth of the surficial organic layer, where present, in centimeters.
  - `soil_taxon_id` integer — Foreign key into table of soil taxa within the USDA classification hierarchy, including Order, Suborder, Greatgroup, Subgroup, Family and Series.
  - `soil_taxon_src` string — How was the soil taxon determined (e.g., field observation, map, other sources)?
  - `percent_bed_rock` number, float — Percent of surface that is exposed bedrock.
  - `percent_rock_gravel` number, float — Percent of surface that is exposed rock and gravel.
  - `percent_wood` number, float — Percent of surface that is wood.
  - `percent_litter` number, float — Percent of surface that is litter.
  - `percent_bare_soil` number, float — Percent of surface that is bare soil.
  - `percent_water` number, float — Percent of surface that is water.
  - `percent_other` number, float — Percent of surface that belong to an additional itemized category
  - `name_other` string — Name of additional itemized ground cover category (e.g., beer cans).
  - `tree_ht` number, float — Height of the tree layer in m.
  - `shrub_ht` number, float — Height of the shrub layer in m.
  - `field_ht` number, float — Height of the field layer in m.
  - `nonvascular_ht` number, float — Height of the nonvascular layer in m.
  - `submerged_ht` number, float — Height of the submerged layer in m.
  - `tree_cover` number, float — Total cover of the tree layer in percent. Includes tall trees (single-stemmed woody plants, generally more than 5 m in height or greater at maturity under optimal growing conditions). Very tall shrubs with tree-like form may also be included here, as may other life forms, such as lianas and epiphytes.
  - `shrub_cover` number, float — Total cover of the shrub layer in percent. Includes shrubs (multiple-stemmed woody plants, generally less than 5 m in height at maturity under optimal growing conditions) and shorter trees (saplings). As with the tree stratum, other life forms present in this stratum may also be included (however, herbaceous life forms should be excluded, as their stems often die back annually and do not have as consistent a height as woody life forms). Where dwarf-shrubs (i.e. shrubs shorter than 0.5 m) form a distinct stratum (either as part of a series of strata, as in a forest, or as the top stratum of more open vegetation, such as tundra or xeric shrublands), they should be treated as a low version of the shrub stratum (or short shrub substratum). In many vegetation types, dwarf-shrubs may simply occur as one life form component of the herb stratum.
  - `field_cover` number, float — Total cover of the field layer in percent. Also referred to as Herb stratum. Includes herbs (plants without woody stems and often dying back annually), often in association with low creeping semi-shrubs, dwarf-shrubs, vines, and non-woody brambles (such as raspberries), as well as tree or shrub seedlings.
  - `nonvascular_cover` number, float — Total cover of the nonvascular layer in percent. Also referred to as moss, bryoid, or ground stratum. Defined entirely by mosses, lichens, liverworts, and alga. Ground-creeping vines, prostrate shrubs and herbs should be treated in the herb stratum. Where herbs are entirely absent, it is still possible to recognize this stratum if other very low woody or semi-woody life forms are present.
  - `floating_cover` number, float — Total cover of the floating layer in percent. Includes rooted or drifting plants that float on the water surface (e.g., duckweed, water-lily).
  - `submerged_cover` number, float — Total cover of the submerged layer in percent. Includes rooted or drifting plants that by-and-large remain submerged in the water column or on the aquatic bottom (e.g., pondweed). The focus is on the overall strata arrangement of these aquatic plants. Note that emergent plants life forms in a wetland should be placed in above water strata (e.g., cattail or sedges would be placed in the herb stratum, whereas the duckweed would be in the floating aquatic stratum).
  - `dominant_stratum` string — Which of the six standard strata is dominant?
  - `growthform1_type` string — The predominant growth form?
  - `growthform2_type` string — The second-most predominant growthform?
  - `growthform3_type` string — The third-most predominant growthform
  - `growthform1_cover` number, float — Total cover of the predominant growthform?
  - `growthform2_cover` number, float — Total cover of the second-most predominant growthform?
  - `growthform3_cover` number, float — Total cover of the third-most predominant growthform?
  - `total_cover` number, float — The total cover, in percent, of all vegetation on the plot.
  - `accession_code` string — Code that uniquely references this record, allowing reference to this record for this version of this database. Better than a primary key, which is automatically generated by a database and not globally unique. VegBank Accession codes are only generated by VegBank, and therefore data integrity can be guaranteed, unlike with a primary key (number).
  - `notes_public` boolean — TRUE indicates that public notes pertaining to this plot exist in 'vegPlot.note'
  - `notes_mgt` boolean — TRUE indicates that nonpublic management notes pertaining to this plot exist in 'vegPlot.note'
  - `revisions` boolean — TRUE indicates that revisions exist in 'vegPlot.Revision'
  - `plot` Plot
    - `author_plot_ode` string — Author's Plot number/code, or the original plot number if taken from literature.
    - `reference_id` integer — Link to the source reference from which this plot record was taken
    - `parent_id` integer — Link to the parent plot when plot is nested within another plot.
    - `real_latitude` number, float — Latitude of the plot origin in degrees and decimals, datum =WGS84
    - `real_longitude` number, float — Longitude of the plot origin in degrees and decimals, datum = WGS84
    - `location_accuracy` number, float — Estimated accuracy of the location of the plot. Plot origin has a 95% or greater probability of being within this many meters of the reported location.
    - `confidentiality_status` integer — Are the data to be considered confidential? 0=no, 1= 1km radius, 2=10km radius, 3=100km radius, 4=location embargo, 5=public embargo on all plot data, 6=full embargo on all plot data. This applies also to region.
    - `confidentiality_reason` string — The reason for confidentiality. This field should not be open to public view. Reasons might include specific rare species, ownership, prepublication embargo, or many other reason
    - `latitude` number, float — Latitude of the plot origin in degrees and decimals, datum =WGS84, fuzzing applied
    - `longitude` number, float — Longitude of the plot origin in degrees and decimals, datum = WGS84, fuzzing applied
    - `author_e` string — Original E-W coordinate as recorded by the author
    - `author_n` string — Original N-S coordinate as recorded by the author
    - `author_zone` string — Original UTM zone reported by the author
    - `author_datum` string — Original datum reported by the author
    - `author_location` string — Original location as described by author (e.g. Town-Range-Section)
    - `location_narrative` string — Text description that provides information useful for plot relocation.
    - `azimuth` number, float — This element stores the azimuth of the x-axis used to describe the relative coordinate system for plot shape (dsgpoly) and other spatial information about the plot. Typically the azimuth is parallel to the long axis of the plot (in the case of a rectangle).
    - `dsgpoly` string — This field is a text string containing the points circumscribing a plot area. These points are anticipated to have been collected using tapes, GPS, or calculated from the plot shape and area. Points are X-Y coordinates in m relative to plot origin.
    - `shape` string — Shape of the plot area.
    - `area` number, float — Total area of the plot in m2. If many subplots, this area includes the subplots and the interstitial space. RESERVED VALUE: -1 is used to indicate that the plot had no boundaries.
    - `stand_size` string — The extent of this community occurrence in relation to the plot size: very extensive (>1000x plot), extensive (>100x plot), large (10-100x plot), small (3-10x plot), very small (1-3x plot).
    - `placement_method` string — Brief description of strategy for determining plot placement within the stand.
    - `permanence` boolean — Is the plot monumented so as to assure permanence? If so, this should be described in the layoutNarrative
    - `layout_narrative` string — Text description of and the rationale for the layout of the plot.
    - `elevation` number, float — The elevation of the plot origin in meters above sea level.
    - `elevation_accuracy` number, float — The accuracy of the elevation in meters.
    - `elevation_range` number, float — Meters of difference in elevations of the high and low points in the plot.
    - `slope_aspect` number, float — Representative azimuth of slope gradient (0-360 degrees); if too flat to determine = -1; if too irregular to determine = -2.
    - `min_slope_aspect` number, float — Minimum azimuth of slope gradient (0-360 degrees), counterclockwise from representative azimuth.
    - `max_slope_aspect` number, float — Maximum azimuth of slope gradient (0-360 degrees), clockwise from representative azimuth
    - `slope_gradient` number, float — Representative inclination of slope in degrees; if too irregular to determine, = -1.
    - `min_slope_gradient` number, float — Minimum inclination of slope in degrees.
    - `max_slope_gradient` number, float — Maximum inclination of slope in degrees.
    - `topo_position` string — Position of the plot on land surface (e.g., Summit, shoulder, upper slope, middle slope, lower slope, toeslope, no slope, channel bed, dune swale, pond).
    - `landform` string — A recognizable physical feature on the surface of the earth, often including consideration of the natural cause of its formation.
    - `surficial_deposits` string — Surficial deposits represent the parent material that are the geologic or organic precursors to the soil. They may either have been deposited by geologic (wind, ice, gravity or water) or biologic (organic) activity, or formed in place more-or-less directly from rocks and minerals below.
    - `rock_type` string — RockType values conform to the lithic types in the FGDC Soil Geographic Data Standards, September 1997. http://www.fgdc.gov/standards/documents/standards/soils/soil997.PDF (pages 56-59).
    - `accession_code` string — Code that uniquely references this record, allowing reference to this record for this version of this database. Better than a primary key, which is automatically generated by a database and not globally unique. VegBank Accession codes are only generated by VegBank, and therefore data integrity can be guaranteed, unlike with a primary key (number).
    - `notes_public` boolean — TRUE indicates that public notes pertaining to this plot exist in 'vegPlot.note'
    - `notes_mgt` boolean — TRUE indicates that nonpublic management notes pertaining to this plot exist in 'vegPlot.note'
    - `revisions` boolean — TRUE indicates that revisions exist in vegPlot.Revision
    - `observation_codes` string[] — list of accession codes to observations for this plot

## Changes

- **2025-05-24** `16a2946a00d0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nceas/apis/vegbankapi/changes/plot-observations/:accession_code/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/16a2946a00d0/schema)