---
title: "Get a specific Application Code by code"
method: GET
path: "/application-codes/{code}"
tags: ["application-codes"]
---

# Get a specific Application Code by code

`GET /application-codes/{code}`

## Request

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

Returns the Application Code matching the supplied code and valid on the supplied date.

## Path parameters

- `code` string, required

## Query parameters

- `date` string, date, required

## 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-07-29** `8a3c6d9862a3`: 1 info
  - the response property `wording/substitution-key-constraints/items/key` became required for the status `200`

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