---
title: "Get plant concept"
method: GET
path: "/plant-concepts/{pc_code}"
tags: ["Plant concepts"]
---

# Get plant concept

`GET /plant-concepts/{pc_code}`

Retrieve a single plant concept using its `pc_code`.

## Path parameters

- `pc_code` string, required

## Query parameters

- `status` 'any' | 'current' | 'accepted' | 'current_accepted'
- `with_nested` boolean
- `create_parquet` boolean

## Response `200`

Matching plant concept(s), with fields based on parameters:
- `detail=full&with_nested=false`: Extended fields, no nested array fields
- `detail=full&with_nested=true`: Extended fields + nested array fields

- union
  - PlantConceptFull
    - `count` integer — Total matching record count
    - `data` PlantConceptFull[] — Data records
  - PlantConceptFullNested
    - `count` integer — Total matching record count
    - `data` object[] — Data records
      - `pc_code` string — VegBank plant concept identifier
      - `plant_name` string — Plant name, as recorded on the plant concept
      - `plant_code` string — Code for the plant concept, derived from a plant usage record of class system 'Code'
      - `plant_description` string — Description of the plant concept by the party contributing the concept
      - `concept_rf_code` string — VegBank identifier for the reference in which the plant was identified by a name.
      - `concept_rf_label` string — Name/label for the reference in which the plant was identified by a name.
      - `status_rf_code` string — VegBank identifier for the reference in which the status was reported
      - `status_rf_label` string — Name/label for the reference in which the status was reported
      - `obs_count` integer — Number of plot observations associated with this entity
      - `plant_level` string — Level in the taxonomic hierarchy to which the plant concept belongs.
      - `status` string — Status of the concept by the party (accepted, not accepted, undetermined)
      - `start_date` string, date — Date for which the status assignment by the party started.
      - `stop_date` string, date — Date for which the status assignment by the party ended.
      - `current_accepted` boolean — Is this concept currently accepted by at least one party?
      - `py_code` string — VegBank identifier for the party that made the status assignment
      - `party_label` string — Name/label for the party that made the status assignment
      - `plant_party_comments` string — Comments by party providing rationale for status assignment
      - `parent_pc_code` string — VegBank identifier of the parent concept in the taxonomic hierarchy. For example, if this concept were at the species level, the parent would be a concept that is the parent genus level.
      - `parent_name` string — Name of the parent concept in the taxonomic hierarchy.
      - `usages` object[] — Name usages for this plant concept
        - `class_system` string — The name of the classification system wherein the name is applied (e.g., Scientific, Spanish common)
        - `plant_name` string — Plant name, as recorded on the plant concept
        - `status` string — Status of the concept by the party (accepted, not accepted, undetermined)
      - `children` object[] — Hierarchical children of this plant concept
        - `pc_code` string — VegBank plant concept identifier
        - `plant_name` string — Plant name, as recorded on the plant concept
      - `correlations` object[] — Other (newer, valid) concepts correlated to this (older, no longer valid) plant concept
        - `pc_code` string — VegBank plant concept identifier
        - `plant_name` string — Plant name, as recorded on the plant concept
        - `convergence` string — Descriptive attribute used to relate the congruence between this concept and each correlated concepts, generally expressed as either greater than, less than, or equal to. For example, if the current concept has been split, the convergence would be 'greater than' (i.e., the old concept is 'greater than' the new concept).

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