---
title: "Get general appointment sub-types."
method: GET
path: "/parameters/appointment-subtypes"
tags: ["Parameters"]
---

# Get general appointment sub-types.

`GET /parameters/appointment-subtypes`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/parameters/appointment-subtypes`
- Auth: `appAuth` (a scheme the document does not define)

Retrieves a list of all the general appointment sub-types supported by the group.
Required scope: alto/read:appointments

## Headers

- `AgencyRef` string, required

## Response `200`

Sub types have been retrieved for general appointments

- DiaryEventSubType[]
  - `id` integer: The unique identifier of the general appointment sub-type
  - `displayName` string, nullable: The name of the general appointment sub-type

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Invalid scope or AgencyRef for request.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)