---
title: "Fetch controlled terms for a taxon"
method: GET
path: "/controlled_terms/for_taxon/{taxon_id}"
tags: ["Controlled Terms"]
---

# Fetch controlled terms for a taxon

`GET /controlled_terms/for_taxon/{taxon_id}`

## Path parameters

- `taxon_id` string[], required

## Query parameters

- `fields` string

## Headers

- `X-HTTP-Method-Override` string

## Response `200`

A list of controlled attributes relevant to a taxon with nested controlled values

- ResultsControlledTerms
  - `total_results` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `results` ControlledTerm[], required
    - `id` integer, required — Unique auto-increment integer identifier.
    - `blocking` boolean
    - `is_value` boolean
    - `excepted_taxon_ids` integer[]
    - `label` string
    - `labels` object[]
      - `id` integer
      - `definition` string
      - `label` string
      - `locale` string
      - `valid_within_clade` integer, nullable
    - `multivalued` boolean
    - `ontology_uri` string
    - `taxon_ids` integer[]
    - `uri` string
    - `uuid` string, uuid, nullable
    - `valid_within_clade` integer, nullable
    - `values` ControlledTerm[]

---

[API](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api.md) · [All operations](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inaturalist/inaturalist-version-2-api/revisions/f739db716aaf/schema)