---
title: "Read Controlled Vocabulary List"
method: GET
path: "/vocab/lists/{cvlid}"
tags: ["Vocabularies"]
---

# Read Controlled Vocabulary List

`GET /vocab/lists/{cvlid}`

## Request

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

Read a controlled vocabulary list.

## Path parameters

- `cvlid` 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 lists are available.

- VocabElementList: Representation of a list of VocabElement objects
  - `title` string: The title of the list of elements.
  - `description` string: The description of the list of elements.
  - `uri` string: The URI of the list of elements.
  - `id` string: The id of the list of elements.
  - `elements` VocabElement[]: The list of elements.
    - `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 lists do 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)