---
title: "Get the exact saved Application Code by ID"
method: GET
path: "/application-codes/by-id/{id}"
tags: ["application-codes"]
---

# Get the exact saved Application Code by ID

`GET /application-codes/by-id/{id}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/application-codes/by-id/{id}`
- Auth: none declared

Returns the requested record, including historical or inactive versions. Unknown IDs return 404 without falling back to a code/date search. Fee metadata may be null when no matching fee exists.

## Path parameters

- `id` integer, required

## Query parameters

- `date` string, date

## Response `200`

Application Code found

- ApplicationCodeGetDetailDto: Immutable DTO representing a detailed Application Code.
  - `applicationCode` string, required: Code that identifies the application.
  - `title` string, required: Human-readable title.
  - `wording` TemplateDetail, required: The wording details
    - `template` string, required: The template name. It contains the field names between curly braces.
    - `substitution-key-constraints` TemplateKeyWithConstraint[]: A list of fields and the associated constraints
      - `key` string, required: Field key for substitution into the template.
      - `value` string: The optional value for the key.
      - `constraint` TemplateConstraint, required: The template field with an associated value
        - `type` 'TEXT', required: The data type of the value.
        - `length` integer, required: The length of the data value.
  - `isFeeDue` boolean, required: True if Application List Entries using this Application Code require an Application List Entry Fee Status to be created and linked.
  - `requiresRespondent` boolean, required: True if Application List Entries using this Application Code require a respondent to be created and linked.
  - `bulkRespondentAllowed` boolean, required: True if Application List Entries using this Application Code allow multiple respondents to be created and linked.
  - `feeReference` string, nullable: A short reference code that identifies a Fee.
  - `feeAmount` ApplicationCodeGetDetailDtoFeeAmount, nullable: Fee amount for this Application Code, expressed in pence (GBP minor units). Always use integer values; 1 GBP = 100 pence.
    - `value` integer, required: Amount in pence.
    - `currency` 'GBP': ISO 4217 currency code (always "GBP" for now).
  - `feeDescription` string, nullable: Descriptive text for the fee.
  - `offsiteFeeReference` string, nullable: A short reference code that identifies a offsite Fee.
  - `offsiteFeeAmount` ApplicationCodeGetDetailDtoOffsiteFeeAmount, nullable: Offsite Fee amount for this Application Code, expressed in pence (GBP minor units). Always use integer values; 1 GBP = 100 pence.
    - `value` integer, required: Amount in pence.
    - `currency` 'GBP': ISO 4217 currency code (always "GBP" for now).
  - `offsiteFeeDescription` string, nullable: Descriptive text for the offsite fee.
  - `startDate` string, date, required: Date the Application Code became active.
  - `endDate` string, date, nullable, required: Date the Application Code became inactive. `null` indicates that this row is still active.

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

## Changes

- **2026-10-27** `269185a6fe8a`: 1 info
  - endpoint added

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