--- title: "Resolve Application List bulk action selection preview" method: POST path: "/application-lists/{listId}/entries/bulk-action-preview" tags: ["application-list-entries"] --- # Resolve Application List bulk action selection preview `POST /application-lists/{listId}/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-lists/{listId}/entries/bulk-action-preview` - Auth: none declared Resolves a selection within a single Application List into entry IDs and row context, enforcing the configured single-list bulk action limit. ## Path parameters - `listId` string, uuid, required ## Request body - ApplicationListEntryBulkActionPreviewRequestDto: Request to resolve a single-list 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` ApplicationListEntryBulkActionSelectionDto, required: Selection criteria for a single Application List 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` EntryApplicationListGetFilterDto: Filter criteria for retrieving Application List Entries for an Application List. - `sequenceNumber` integer: The sequence number of the application in the list. This has to be Exact. - `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. - `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. - `feeRequired` boolean: Whether a fee is required for the application. This has to be Exact. - `resulted` string: The application resolution code. 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 Application List 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. - `404`: The requested resource was not found. - `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`: 1 info - endpoint added - **2026-07-16** `3227b7d2edf5`: 1 breaking - api path removed without deprecation - **2026-07-16** `046928d7f2a6`: 1 info - endpoint added [Operation history](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/changes/application-lists/:listId/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)