---
title: "Get an Application List by id"
method: GET
path: "/application-lists/{listId}"
tags: ["application-lists"]
---

# Get an Application List by id

`GET /application-lists/{listId}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/application-lists/{listId}`
- Auth: none declared

Returns the Application List identified by `listId`.

## Path parameters

- `listId` string, uuid, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `sort` string[]

## Response `200`

Application List detail

- ApplicationListGetDetailDto: Immutable DTO representing a detailed Application List.
  - `id` string, uuid, required: Unique identifier of the Application List.
  - `date` string, date, required: The calendar date on which the Application List is scheduled.
  - `time` string, time, required: The time of day at which the Application List is scheduled, seconds are optional.
  - `description` string, required: Human-readable description of the Application List (e.g. session title or purpose).
  - `status` 'OPEN' | 'CLOSED', required: Status of the Application List.
  - `courtCode` string: Code that identifies the Court Location.
  - `courtName` string: Name that identifies the Court Location.
  - `cjaCode` string: Criminal Justice Area code.
  - `otherLocationDescription` string: Free-text location if not using a standard court.
  - `durationHours` integer: Duration hours component.
  - `durationMinutes` integer: Duration minutes component.
  - `version` integer, required: Current resource version for optimistic concurrency.
  - `entriesCount` integer: Total number of Application List Entries associated with this Application List.

## Other responses

- `400`: Invalid request parameters.
- `401`: Authentication required or token invalid.
- `403`: Authenticated but not permitted to perform this action.
- `404`: The requested resource was not found.
- `500`: Unexpected server error.

## Changes

- **2026-06-24** `d2802ab9d102`: 1 warning
  - removed the optional property `entriesSummary` from the response with the `200` status

[Operation history](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/changes/application-lists/:listId/get.md)

---

[API](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api.md) - [All operations](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/revisions/36521cfe1ab7?raw)
