HMhm-courts-and-tribunals-service
application-lists

Get an Application List by id

Changed on

Returns the Application List identified by listId.

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

Path parameters

listIdstring uuid required

Public identifier of the Application List.

Query parameters

pageNumberinteger

Zero-based page index.

pageSizeinteger

Page size.

sortstring[]

Sort parameter. Format: property,(asc|desc). Currently only a single sort value is supported. Example: ?sort=name,asc.

[
  "name,asc"
]

Response

Application List detail

idstring uuid required

Unique identifier of the Application List.

datestring date required

The calendar date on which the Application List is scheduled.

timestring time required

The time of day at which the Application List is scheduled, seconds are optional.

descriptionstring required

Human-readable description of the Application List (e.g. session title or purpose).

status'OPEN' | 'CLOSED' required

Status of the Application List.

courtCodestring

Code that identifies the Court Location.

courtNamestring

Name that identifies the Court Location.

cjaCodestring

Criminal Justice Area code.

otherLocationDescriptionstring

Free-text location if not using a standard court.

durationHoursinteger

Duration hours component.

durationMinutesinteger

Duration minutes component.

versioninteger required

Current resource version for optimistic concurrency.

entriesCountinteger

Total number of Application List Entries associated with this Application List.

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "date": "2025-09-17",
  "time": "10:30:00",
  "description": "Morning session for traffic-related applications",
  "status": "OPEN",
  "courtCode": "LOC123",
  "courtName": "Bath Magistrates Court",
  "cjaCode": "CJA001",
  "otherLocationDescription": "Temporary Courtroom at Town Hall",
  "durationHours": 2,
  "durationMinutes": 30,
  "version": 3,
  "entriesCount": 12
}

Changes