---
title: "Get community classification"
method: GET
path: "/community-classifications/{cl_code}"
tags: ["Community classifications"]
---

# Get community classification

`GET /community-classifications/{cl_code}`

Retrieve a single community classification using its `cl_code`.

## Path parameters

- `cl_code` string, required

## Query parameters

- `detail` 'minimal' | 'full'
- `with_nested` boolean
- `create_parquet` boolean

## Response `200`

Matching community classification(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
  - CommClassMinimal
    - `count` integer — Total matching record count
    - `data` CommClassMinimal[] — Data records
  - CommClassMinimalNested
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `cl_code` string — VegBank community classification identifier
      - `ob_code` string — VegBank plot observation identifier
      - `class_start_date` string, date — Start date for the application of a vegetation class to a plot observation by one or more parties.
      - `class_stop_date` string, date — Stop date for the application of a vegetation class to a plot observation by one or more parties.
      - `inspection` boolean — Was the classification informed by simple inspection of data?
      - `table_analysis` boolean — Was the classification informed by inspection of floristic composition tables?
      - `multivariate_analysis` boolean — Was the classification informed by use of multivariate numerical tools?
      - `expert_system` string — Description of any automated expert system used in classification
      - `class_publication_rf_code` string — VegBank reference identifier for the publication wherein the observation was classified
      - `class_publication_rf_label` string — Reference label for the publication wherein the observation was classified
      - `class_notes` string — Notes about the classification event by the parties participating in the event. This might include the purpose or rationale for the classification.
      - `interpretations` object[] — Basic details about the community interpretations made as part of this classification
        - `ci_code` string — VegBank community interpretation identifier
        - `cc_code` string — VegBank community concept identifier
        - `comm_code` string — Code for the community concept, derived from a comm usage record of class system 'Code'
        - `comm_name` string — Community name, as recorded on the community concept
      - `contributors` object[] — Contributors to this community classification
        - `py_code` string — VegBank party identifier for the classification contributor
        - `party_label` string — Party label for the classification contributor
        - `role` string — Role descriptor for the classification contributor
  - CommClassFull
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `cl_code` string — VegBank community classification identifier
      - `ob_code` string — VegBank plot observation identifier
      - `class_start_date` string, date — Start date for the application of a vegetation class to a plot observation by one or more parties.
      - `class_stop_date` string, date — Stop date for the application of a vegetation class to a plot observation by one or more parties.
      - `inspection` boolean — Was the classification informed by simple inspection of data?
      - `table_analysis` boolean — Was the classification informed by inspection of floristic composition tables?
      - `multivariate_analysis` boolean — Was the classification informed by use of multivariate numerical tools?
      - `expert_system` string — Description of any automated expert system used in classification
      - `class_publication_rf_code` string — VegBank reference identifier for the publication wherein the observation was classified
      - `class_publication_rf_label` string — Reference label for the publication wherein the observation was classified
      - `class_notes` string — Notes about the classification event by the parties participating in the event. This might include the purpose or rationale for the classification.
      - `author_obs_code` string — Code or name provided by the author to identify the classified plot observation.
  - CommClassFullNested
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `cl_code` string — VegBank community classification identifier
      - `ob_code` string — VegBank plot observation identifier
      - `class_start_date` string, date — Start date for the application of a vegetation class to a plot observation by one or more parties.
      - `class_stop_date` string, date — Stop date for the application of a vegetation class to a plot observation by one or more parties.
      - `inspection` boolean — Was the classification informed by simple inspection of data?
      - `table_analysis` boolean — Was the classification informed by inspection of floristic composition tables?
      - `multivariate_analysis` boolean — Was the classification informed by use of multivariate numerical tools?
      - `expert_system` string — Description of any automated expert system used in classification
      - `class_publication_rf_code` string — VegBank reference identifier for the publication wherein the observation was classified
      - `class_publication_rf_label` string — Reference label for the publication wherein the observation was classified
      - `class_notes` string — Notes about the classification event by the parties participating in the event. This might include the purpose or rationale for the classification.
      - `author_obs_code` string — Code or name provided by the author to identify the classified plot observation.
      - `interpretations` object[] — Extended details about the community interpretations made as part of this classification
        - `ci_code` string — VegBank community interpretation identifier
        - `cc_code` string — VegBank community concept identifier
        - `comm_code` string — Code for the community concept, derived from a comm usage record of class system 'Code'
        - `comm_name` string — Community name, as recorded on the community concept
        - `comm_label` string — Community label, derived from the community concept name and reference
        - `class_fit` string — Degree of fit with the community concept being assigned. Values derive from Gopal, S., and Woodcock, C. (1994), Theory and methods for accuracy assessment of thematic maps using fuzzy sets. Photogrammetric Engineering and Remote Sensing 60(2):181-188
        - `class_confidence` string — Degree of confidence of the interpreter(s) in the interpretation made. This can reflect the level of familiarity with the classification or the sufficiency of information about the plot (e.g., High, Moderate, Low)
        - `comm_authority_rf_code` string — VegBank reference identifier for the reference from which information on the community concept was obtained during the classification event
        - `comm_authority_name` string — Reference label for the publication wherein the observation was classified
        - `notes` string — Notes pertaining to the classification analysis and decision
        - `type` boolean — Is this assignment the type description for the community concept, as indicated in the publication referenced in community classification class_publication?
        - `nomenclatural_type` boolean — Is this a typal plot for the Braun-Blanquet community name?
      - `contributors` object[] — Contributors to this community classification
        - `py_code` string — VegBank party identifier for the classification contributor
        - `party_label` string — Party label for the classification contributor
        - `role` string — Role descriptor for the classification contributor

## 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)
