---
title: "Lookup values by type"
method: GET
path: "/lookup-codes/{lookupName}"
tags: ["Reference Data"]
---

# Lookup values by type

`GET /lookup-codes/{lookupName}`

This endpoint is designed for loading lookup values (reference data).

A lookup consists of a sequence of values. A lookup value is essentially a code-and-description pair and optionally a sort-order value. Where present, the sort-order provides the correct ordering of the lookup values.

There's a number of lookups of different types available in the system. This endpoint enables retrieval of the full set of lookup values of a provided lookup type.

**Lookup types grouped by area of use** Valuation of shop/warehouse/office/land/misc - \`basisOfMeasurement\` - \`useCode\` - \`floor\` - \`year\` - \`adjCode\` - \`oaCode\` - \`otherAdditionsDfe\` Valuation of licensed premises - \`lpAgeDfe\` - \`lpClass\` - \`lpExtension\` - \`lpGrade\` - \`lpLocation\` - \`lpType\` Check case submission - \`codeOfGroundsDfe\` Challenge case submission - \`challengeCodeOfGroundsDfe\`

## Path parameters

- `lookupName` string, required

## Headers

- `Accept` 'application/vnd.hmrc.2.0+json', required

## Response `200`

- LookupsResponseSchemaJson — unresolved $ref

## Other responses

- `404`

---

[API](https://skmtc.net/hmrc/apis/business-rates-api.md) · [All operations](https://skmtc.net/hmrc/apis/business-rates-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/business-rates-api/revisions/669a30d937df/schema)