---
title: "Get Application Lists (paginated, filterable)"
method: GET
path: "/application-lists"
tags: ["application-lists"]
---

# Get Application Lists (paginated, filterable)

`GET /application-lists`

## Request

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

Returns a paginated list of Application Lists.

## Query parameters

- `filter` ApplicationListGetFilterDto: Filter criteria for GET /application-lists.
  - `date` string, date: Single date of the Application List.
  - `time` string, time: Single time of the Application List.
  - `courtLocationCode` string: Court Location code (exact match).
  - `cjaCode` string: CJA code (exact match).
  - `description` string: Case-insensitive contains match on description.
  - `otherLocationDescription` string: Case-insensitive contains match on other location description.
  - `status` 'OPEN' | 'CLOSED': Status of the Application List.
  - `hasEntries` boolean: Filters lists by active entries: true returns lists with at least one entry; false returns lists with no active entries.
- `pageNumber` integer
- `pageSize` integer
- `sort` string[]

## Response `200`

Page of Application Lists

- ApplicationListPage: Generic Spring Data page.
  - `pageNumber` integer, required: Zero-based page index.
  - `pageSize` integer, required: Page size.
  - `totalElements` integer, required: Total number of elements across all pages.
  - `totalPages` integer: Total number of pages.
  - `sort` Sort: Sorting state for the returned page.
    - `orders` SortOrdersInner[]: Active sort orders in priority order.
      - `property` string, required: Property name used for sorting.
      - `direction` 'asc' | 'desc', required: Sort direction.
  - `first` boolean
  - `last` boolean
  - `elementsOnPage` integer, required: Total number of elements in the current page.
  - `content` ApplicationListGetSummaryDto[], required
    - `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.
    - `location` string, required: Location where the applications will be considered.
    - `description` string, required: Human-readable description of the Application List (e.g. session title or purpose).
    - `entriesCount` integer: Total number of Application List Entries associated with this Application List.
    - `status` 'OPEN' | 'CLOSED', required: Status of the Application List.

## Other responses

- `400`: Invalid request parameters.
- `401`: Authentication required or token invalid.
- `403`: Authenticated but not permitted to perform this action.
- `406`: Requested media type/version not acceptable.
- `500`: Unexpected server error.

---

[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)
