---
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}`

## Request

- Base URL: `https://api.inaturalist.org/v2`
- URL: `https://api.inaturalist.org/v2/controlled_terms/for_taxon/{taxon_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/inaturalist/apis/inaturalist-version-2-api/docs/controlled_terms/for_taxon/:taxon_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/inaturalist/apis/inaturalist-version-2-api.md) - [All operations](https://skmtc.dev/inaturalist/apis/inaturalist-version-2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inaturalist/apis/inaturalist-version-2-api/revisions/f739db716aaf?raw)