---
title: "Create an Application List"
method: POST
path: "/application-lists"
tags: ["application-lists"]
---

# Create an Application List

`POST /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

Creates a new Application List from the supplied request body.

## Request body

- ApplicationListCreateDto: Request payload to create an Application List. Blank fields will be rejected, nulls should be used instead.
  - `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
  - `status` 'OPEN' | 'CLOSED', required: Status of the Application List.
  - `courtLocationCode` string: Code that identifies the Court Location.
  - `otherLocationDescription` string: Free-text location if not using a standard court.
  - `cjaCode` string: Criminal Justice Area code.
  - `durationHours` integer
  - `durationMinutes` integer

## Response `201`

Application List created

- 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.
- `500`: Unexpected server error.

## Changes

- **2026-08-20** `f9ed11a47c1d`: 1 warning
  - the `durationHours` request property's max was set to `99.00`
- **2026-06-24** `d2802ab9d102`: 1 warning
  - removed the optional property `entriesSummary` from the response with the `201` status

[Operation history](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/changes/application-lists/post.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)