---
title: "Asynchronously gets the BDMS.Models.Codelists, optionally filtered by schema."
method: GET
path: "/api/v{version}/codelist"
tags: ["CodeList"]
---

# Asynchronously gets the BDMS.Models.Codelists, optionally filtered by schema.

`GET /api/v{version}/codelist`

## Path parameters

- `version` string, required

## Query parameters

- `schema` string
- `testKindIds` integer[]

## Response `200`

OK

- Codelist[]
  - `id` integer, required
  - `geolcode` integer, nullable — Gets or sets the BDMS.Models.Codelist's geolcode.
  - `schema` string, nullable — Gets or sets the BDMS.Models.Codelist's schema.
  - `code` string — Gets or sets the BDMS.Models.Codelist's code.
  - `en` string — Gets or sets the BDMS.Models.Codelist's english text.
  - `de` string, nullable — Gets or sets the BDMS.Models.Codelist's german text.
  - `fr` string, nullable — Gets or sets the BDMS.Models.Codelist 's french text.
  - `it` string, nullable — Gets or sets the BDMS.Models.Codelist's italian text.
  - `ro` string, nullable — Gets or sets the BDMS.Models.Codelist's romantsch text.
  - `order` integer, nullable — Gets or sets the BDMS.Models.Codelist's order.
  - `conf` string, nullable — Gets or sets the BDMS.Models.Codelist's configuration.
  - `isDefault` boolean, nullable — Gets or sets whether the BDMS.Models.Codelist is default.
  - `path` LTree
    - `nLevel` integer

## Changes

- **2026-06-03** `d9f37189e0ef` — 3 breaking
  - the response property `items/id` became optional for the status `200` (media type: text/plain)
  - the response property `items/id` became optional for the status `200` (media type: application/json)
  - the response property `items/id` became optional for the status `200` (media type: text/json)
  - …this revision’s changelog is incomplete

[Change history](https://skmtc.dev/geoadmin/apis/boreholes-rest-api-v2/changes/api/v:version/codelist/get.md)

---

[API](https://skmtc.dev/geoadmin/apis/boreholes-rest-api-v2.md) · [All operations](https://skmtc.dev/geoadmin/apis/boreholes-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geoadmin/boreholes-rest-api-v2/revisions/4b5d5e7caaa2/schema)