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

Get print-ready Application Lists in bulk

Changed on

Returns print-oriented Application Lists for one or more Application Lists in a single request. Supply listIds to scope the search. If entryIds is omitted or empty, all active entries from the supplied lists are returned. If entryIds is supplied, only the specified active entries from the supplied lists are returned within each returned list. Validation is all-or-nothing.

post/application-lists/print

Request

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

Request body

listIdsstring[] required

Public identifiers of the Application Lists to read from. Must be non-empty, contain no duplicates, and contain at most 2000 items. Response order follows the supplied listIds order when entryIds is omitted or empty.

entryIdsstring[]

Optional public identifiers of specific Application List Entries to return. If omitted or empty, all active entries from the supplied listIds are returned. If supplied, the response follows the supplied entryIds order. Duplicates are rejected.

Example request

{
  "listIds": [
    "123e4567-e89b-12d3-a456-426655440000",
    "123e4567-e89b-12d3-a456-426655440001"
  ],
  "entryIds": [
    "123e4567-e89b-12d3-a456-426655440100",
    "123e4567-e89b-12d3-a456-426655440101"
  ]
}

Response

Matching print-ready Application Lists in input order.

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.

courtNamestring

Name that identifies the Court Location.

cjastring

The Criminal Justice Area code and description.

otherLocationDescriptionstring

Free-text location if not using a standard court.

durationstring

The length of the hearing that heard the Application List.

Example response

[
  {
    "date": "2025-09-17",
    "time": "10:30:00",
    "courtName": "Bath Magistrates Court",
    "cja": "52 - Avon & Somerset",
    "otherLocationDescription": "Temporary Courtroom at Town Hall",
    "duration": "1 hour, 30 minutes",
    "entries": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "applicant": {
          "person": {
            "name": {
              "title": "Mr, Mrs",
              "firstName": "John",
              "middleName": "James",
              "lastName": "Smith"
            },
            "contactDetails": {
              "addressLine1": "10 Downing Street",
              "addressLine2": "Westminster",
              "addressLine3": "London",
              "addressLine4": "Greater London",
              "addressLine5": "United Kingdom",
              "postcode": "SW1A 2AA",
              "phone": "01225 123456",
              "mobile": "07123456789",
              "email": "john-doe@gmail.com"
            }
          },
          "organisation": {
            "name": "ACME Industries LTD",
            "contactDetails": {
              "addressLine1": "10 Downing Street",
              "addressLine2": "Westminster",
              "addressLine3": "London",
              "addressLine4": "Greater London",
              "addressLine5": "United Kingdom",
              "postcode": "SW1A 2AA",
              "phone": "01225 123456",
              "mobile": "07123456789",
              "email": "john-doe@gmail.com"
            }
          }
        },
        "respondent": {
          "person": {
            "name": {
              "title": "Mr, Mrs",
              "firstName": "John",
              "middleName": "James",
              "lastName": "Smith"
            },
            "contactDetails": {
              "addressLine1": "10 Downing Street",
              "addressLine2": "Westminster",
              "addressLine3": "London",
              "addressLine4": "Greater London",
              "addressLine5": "United Kingdom",
              "postcode": "SW1A 2AA",
              "phone": "01225 123456",
              "mobile": "07123456789",
              "email": "john-doe@gmail.com"
            },
            "dateOfBirth": "1990-01-01"
          },
          "organisation": {
            "name": "ACME Industries LTD",
            "contactDetails": {
              "addressLine1": "10 Downing Street",
              "addressLine2": "Westminster",
              "addressLine3": "London",
              "addressLine4": "Greater London",
              "addressLine5": "United Kingdom",
              "postcode": "SW1A 2AA",
              "phone": "01225 123456",
              "mobile": "07123456789",
              "email": "john-doe@gmail.com"
            }
          }
        },
        "applicationCode": "AD99001",
        "applicationTitle": "Appeal to Crown Court",
        "applicationWording": "Notice of appeal in respect of a case heard on 10-01-2026",
        "resultWordings": [
          "Appeal forwarded to Bristol Crown Court.",
          "Respondent Attended."
        ],
        "officials": [
          {
            "title": "Mr, Mrs",
            "surname": "Smith",
            "forename": "John",
            "type": "MAGISTRATE"
          }
        ],
        "caseReference": "CASE-001",
        "accountReference": "CCC-001",
        "notes": "Time is 10:31, we have convened to talk about Application..."
      }
    ]
  }
]

Changes