---
title: "Detailed message"
method: GET
path: "/my-organisation/messages/{messageId}"
tags: ["Messages"]
---

# Detailed message

`GET /my-organisation/messages/{messageId}`

This endpoint allows a user to retrieve information about a singular message relating to property links, check cases and challenges.

The message can be returned using one of the following projections:

- <b>legacy</b> - (default in v 2.0) a legacy JSON structure of the message, potentially to be retired from future versions of the API
- <b>data</b> - the response includes an array of data items that make up the message
- <b>html</b> - a basic HTML-rendered version of the whole message is included as a field in the JSON response

Note that:

<ul class="list-bullet">
    <li class="font-xsmall">
        Individuals or organisations can only access their own data, and must be enrolled for the <a href="https://www.gov.uk/correct-your-business-rates" target="_blank">Find and check your business rates valuation</a>  online service.
    </li>
</ul>

## Path parameters

- `messageId` integer, required

## Query parameters

- `projection` 'data' | 'html' | 'legacy'

## Headers

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

## Response `200`

- union
  - GetMessageDetailedResponseSchemaJson — unresolved $ref
  - GetMessageDetailedHtmlResponseSchemaJson — unresolved $ref
  - GetMessageDetailedDataResponseSchemaJson — unresolved $ref

---

[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)