---
title: "Resolve global bulk action selection preview"
method: POST
path: "/application-list-entries/bulk-action-preview"
tags: ["application-list-entries"]
---

# Resolve global bulk action selection preview

`POST /application-list-entries/bulk-action-preview`

## Request

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

Resolves the current global Application List Entry selection into entry IDs and row context for the next bulk action page, enforcing the configured global bulk action limit.

## Request body

- BulkActionPreviewRequestDto: Request to resolve a global bulk action selection into IDs and row context.
  - `action` 'RESULT_SELECTED' | 'UPDATE_NOTES' | 'MOVE_ENTRIES' | 'UPDATE_OFFICIALS' | 'UPDATE_FEE_DETAILS' | 'PRINT_CONTINUOUS' | 'PRINT_PAGE', required: Supported bulk action types.
  - `selection` BulkActionSelectionDto, required: Selection criteria for a global bulk action preview. When selectionType is IDS, entryIds must contain at least one non-null entry ID. When selectionType is FILTER, filter, sort, and excludedEntryIds describe the select-all-matching selection.
    - `selectionType` 'FILTER' | 'IDS', required: How the global bulk action selection should be resolved.
    - `filter` EntryGetFilterDto: Filter criteria for retrieving Application List Entries.
      - `date` string, date: The date on which the application's hearing is scheduled. This has to be Exact.
      - `courtCode` string: Name of the court or session where the application is being heard. This has to be Exact.
      - `otherLocationDescription` string: Description of an alternative location for the hearing. This can be Partial.
      - `cjaCode` string: The Criminal Justice Area (CJA) associated with the application. This has to be Exact.
      - `applicantOrganisation` string: The name of the organisation submitting the application. This can be Partial.
      - `applicantSurname` string: The surname of the applicant if the applicant is an individual. This can be Partial.
      - `standardApplicantCode` string: Unique code identifying the standard applicant. This can be Partial.
      - `status` 'OPEN' | 'CLOSED': Status of the Application List.
      - `respondentOrganisation` string: The name of the organisation responding to the application.
      - `respondentSurname` string: The surname of the respondent if the respondent is an individual.
      - `respondentPostcode` string: The postcode associated with the respondent’s address. This can be Partial.
      - `accountReference` string: Reference code identifying the applicant’s account. This can be Partial.
      - `applicationTitle` string: The title of the application. This can be Partial.
      - `applicantName` string: The applicant display name. For people this uses the format "firstName lastName"; for organisations this uses the organisation name. This can be Partial.
      - `respondentName` string: The respondent display name. For people this uses the format "firstName lastName"; for organisations this uses the organisation name. This can be Partial.
    - `sort` string[]: Sort order for the resolved selection. A single value is currently supported. Format: `property,(asc|desc)`.
    - `entryIds` string[]: Explicitly selected Application List Entry IDs.
    - `excludedEntryIds` string[]: Entry IDs excluded from a select-all-matching filter selection.

## Response `200`

Bulk action preview for the resolved selection.

- BulkActionPreviewResponseDto: Resolved preview for a global bulk action selection.
  - `action` 'RESULT_SELECTED' | 'UPDATE_NOTES' | 'MOVE_ENTRIES' | 'UPDATE_OFFICIALS' | 'UPDATE_FEE_DETAILS' | 'PRINT_CONTINUOUS' | 'PRINT_PAGE', required: Supported bulk action types.
  - `limit` integer, required
  - `selectedCount` integer, required
  - `eligibleCount` integer, required
  - `ineligibleCount` integer, required
  - `entryIds` string[], required
  - `entries` EntryGetSummaryDto[], required
    - `id` string, uuid, required: Unique identifier of the Application List Entry.
    - `applicant` Applicant: The applicant making the application. In application read and print responses, Standard Applicants are represented by their reference name in organisation.name (or their code when no reference name exists). Their personal and contact values are not returned. For these read responses the shared input contact constraints do not apply: contact fields may be null or absent. Ordinary applicant input still requires the person or organisation contact details.
      - `person` Person: The person making, or responding to, the application.
        - `name` FullName, required: A persons full name. Blank fields will be rejected, nulls should be used instead.
          - `title` string: Prefix before a persons name.
          - `firstName` string, required: The person's first name.
          - `middleName` string, nullable: The person's optional middle name or names.
          - `lastName` string, required: The person's family name.
        - `contactDetails` ContactDetails, required: A participant's contact details. Blank fields will be rejected, nulls should be used instead.
          - `addressLine1` string, required: Line one of the participant's address.
          - `addressLine2` string, nullable: Line two of the participant's address.
          - `addressLine3` string, nullable: Line three of the participant's address.
          - `addressLine4` string, nullable: Line four of the participant's address.
          - `addressLine5` string, nullable: Line five of the participant's address.
          - `postcode` string: The participant's postcode.
          - `phone` string, nullable: The participant's home-phone number.
          - `mobile` string, nullable: The participant's mobile number.
          - `email` string, nullable: The participant's email address.
      - `organisation` Organisation: The organisation making, or responding to, the application. Blank fields will be rejected, nulls should be used instead.
        - `name` string, required: The name of the organisation.
        - `contactDetails` ContactDetails, required: A participant's contact details. Blank fields will be rejected, nulls should be used instead.
          - `addressLine1` string, required: Line one of the participant's address.
          - `addressLine2` string, nullable: Line two of the participant's address.
          - `addressLine3` string, nullable: Line three of the participant's address.
          - `addressLine4` string, nullable: Line four of the participant's address.
          - `addressLine5` string, nullable: Line five of the participant's address.
          - `postcode` string: The participant's postcode.
          - `phone` string, nullable: The participant's home-phone number.
          - `mobile` string, nullable: The participant's mobile number.
          - `email` string, nullable: The participant's email address.
    - `respondent` Respondent: The respondent to the application.
      - `person` RespondentPerson: Person details for a respondent (includes DOB).
        - `name` FullName, required: A persons full name. Blank fields will be rejected, nulls should be used instead.
          - `title` string: Prefix before a persons name.
          - `firstName` string, required: The person's first name.
          - `middleName` string, nullable: The person's optional middle name or names.
          - `lastName` string, required: The person's family name.
        - `contactDetails` ContactDetails, required: A participant's contact details. Blank fields will be rejected, nulls should be used instead.
          - `addressLine1` string, required: Line one of the participant's address.
          - `addressLine2` string, nullable: Line two of the participant's address.
          - `addressLine3` string, nullable: Line three of the participant's address.
          - `addressLine4` string, nullable: Line four of the participant's address.
          - `addressLine5` string, nullable: Line five of the participant's address.
          - `postcode` string: The participant's postcode.
          - `phone` string, nullable: The participant's home-phone number.
          - `mobile` string, nullable: The participant's mobile number.
          - `email` string, nullable: The participant's email address.
        - `dateOfBirth` string, date: Date of birth (only applicable for person respondents).
      - `organisation` Organisation: The organisation making, or responding to, the application. Blank fields will be rejected, nulls should be used instead.
        - `name` string, required: The name of the organisation.
        - `contactDetails` ContactDetails, required: A participant's contact details. Blank fields will be rejected, nulls should be used instead.
          - `addressLine1` string, required: Line one of the participant's address.
          - `addressLine2` string, nullable: Line two of the participant's address.
          - `addressLine3` string, nullable: Line three of the participant's address.
          - `addressLine4` string, nullable: Line four of the participant's address.
          - `addressLine5` string, nullable: Line five of the participant's address.
          - `postcode` string: The participant's postcode.
          - `phone` string, nullable: The participant's home-phone number.
          - `mobile` string, nullable: The participant's mobile number.
          - `email` string, nullable: The participant's email address.
    - `applicationTitle` string, required: Descriptive title of the application.
    - `legislation` string: Legislation under which the application is made.
    - `isFeeRequired` boolean, required: True if submitting the application incurs a charge.
    - `isResulted` boolean, required: True if this application list entry has been resulted.
    - `listId` string, uuid: Unique Identifier of the Application List to which this entry belongs.
    - `date` string, date: Single date of the Application List.
    - `sequenceNumber` integer: The sequence number of the application in the list.
    - `resulted` ResultCodeGetSummaryDto[]: List of result codes applied to this application list entry.
      - `resultCode` string, required: Code that identifies the result.
      - `title` string, required: Human-readable title.
    - `status` 'OPEN' | 'CLOSED', required: Status of the Application List.
    - `accountNumber` string, nullable

## 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.
- `413`: Request entity is too large to be processed.
- `500`: Unexpected server error.

## Changes

- **2026-07-16** `482b3d8a723e`: 3 warning, 3 info
  - added the new `MOVE_ENTRIES` enum value to the `action` response property for the response status `200`
  - added the new `UPDATE_FEE_DETAILS` enum value to the `action` response property for the response status `200`
  - added the new `UPDATE_OFFICIALS` enum value to the `action` response property for the response status `200`
  - added the new `MOVE_ENTRIES` enum value to the request property `action`
  - …2 more
- **2026-07-16** `3227b7d2edf5`: 3 breaking, 3 info
  - removed the enum value `MOVE_ENTRIES` of the request property `action`
  - removed the enum value `UPDATE_FEE_DETAILS` of the request property `action`
  - removed the enum value `UPDATE_OFFICIALS` of the request property `action`
  - removed the `MOVE_ENTRIES` enum value from the `action` response property for the response status `200`
  - …2 more
- **2026-07-16** `046928d7f2a6`: 3 warning, 3 info
  - added the new `MOVE_ENTRIES` enum value to the `action` response property for the response status `200`
  - added the new `UPDATE_FEE_DETAILS` enum value to the `action` response property for the response status `200`
  - added the new `UPDATE_OFFICIALS` enum value to the `action` response property for the response status `200`
  - added the new `MOVE_ENTRIES` enum value to the request property `action`
  - …2 more
- **2026-07-08** `c4d4d0594f33`: 1 info
  - endpoint added

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