---
title: "Read Controlled Vocabulary Term"
method: GET
path: "/vocab/terms/{cvtid}"
tags: ["Vocabularies"]
---

# Read Controlled Vocabulary Term

`GET /vocab/terms/{cvtid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/vocab/terms/{cvtid}`
- Auth: HTTP bearer

Read a controlled vocabulary term.

## Path parameters

- `cvtid` string, required

## Headers

- `Accept` 'application/ld+json' | 'application/x-fs-v1+json' | 'application/json' | 'application/rdf+xml' | 'application/x-fs-v1+xml' | 'application/xml', required

## Response `200`

The term is available.

- VocabElement: Representation of a vocabulary element
  - `id` string: The id of the element.
  - `uri` string: The URI of the element.
  - `subclass` string: The subclass of the element.
  - `type` string: The type of the element.
  - `labels` TextValue[]: The labels of the element.
    - `lang` string: The language of the text value. See http://www.w3.org/International/articles/language-tags/
    - `value` string: The text value.
  - `descriptions` TextValue[]: The descriptions of the element.
    - `lang` string: The language of the text value. See http://www.w3.org/International/articles/language-tags/
    - `value` string: The text value.
  - `sublist` string: The sublist of the element.
  - `position` integer
  - `sortName` string

## Other responses

- `404`: The term does not exist.

---

[API](https://skmtc.dev/familysearch/apis/standards-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/standards-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/standards-endpoints/revisions/bfeea6bf67e2?raw)