---
title: "Search controlled terms"
method: GET
path: "/controlled_terms"
tags: ["Controlled Terms"]
---

# Search controlled terms

`GET /controlled_terms`

## Query parameters

- `fields` string

## Headers

- `X-HTTP-Method-Override` string

## Response `200`

A list of all controlled terms

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