---
title: "Get contact-type terminology"
method: GET
path: "/api/terminology/contact-types"
tags: ["Terminology"]
---

# Get contact-type terminology

`GET /api/terminology/contact-types`

Returns each stable contact-type code with its display label for your resolved context. You receive US labels when not opted in and Canadian labels when opted in (same resolution as the rest of the API; pass `?terminology=en-CA` to opt in per request). The stable code is always returned alongside each label and never changes with terminology, so it is safe to key on. Responses are safe to cache keyed on your resolved preference.

### Validation & Requirements
#### Required Parameters
- None

#### Required JSON Body Fields
- None

#### Validations
- Invalid GUID values in `*Guid`/`*Guids` fields return `422 Unprocessable Entity`.
- Invalid date values in `*date*` fields return `422 Unprocessable Entity`.
- Missing required request body returns `422 Unprocessable Entity` with `Missing request body.`.
- Additional business-rule validation may return `422` with details in the `errors` array.

## Response `200`

- LinkedResponseOfTerminologyReferenceResponse
  - `value` TerminologyReferenceResponse
    - `locale` string, nullable
    - `contactTypes` ContactTypeTerm[], nullable
      - `code` string, nullable
      - `id` integer
      - `displayLabel` string, nullable
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `422`

---

[API](https://skmtc.net/skyslope/apis/skyslope-api.md) · [All operations](https://skmtc.net/skyslope/apis/skyslope-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyslope/skyslope-api/revisions/bad0d2db9b7a/schema)