---
title: "Messages summary"
method: GET
path: "/my-organisation/messages"
tags: ["Messages"]
---

# Messages summary

`GET /my-organisation/messages`

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

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>

<h3 class="govuk-heading-m">Available correspondence types</h3>


<table class="govuk-table">
  <caption class="govuk-table__caption govuk-table__caption--m">Check</caption>
  <thead class="govuk-table__head">
    <tr class="govuk-table__row"><th scope="col" class="govuk-table__header">Template</th><th scope="col" class="govuk-table__header">Correspondence title</th></tr>
  </thead>
  <tbody class="govuk-table__body">
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C007</th><td class="govuk-table__cell">Correspondence regarding your Check case</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C010</th><td class="govuk-table__cell">Check acknowledgement</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C011</th><td class="govuk-table__cell">No Change Check (No RV Change)</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C011</th><td class="govuk-table__cell">No Change Check (No RV Change) decision notice</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Check Decision Notice</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Agree no RV change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Agree RV change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Agree RV No Change - Change in effective date</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Change (Split/Merger/Recon)</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Change in the locality No RV Change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Covid Change in the locality No RV Change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Deletion/ exemption Agree</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Disagree change (Merge/recon) actioned on separate check</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Disagree No RV change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Disagree RV Decrease</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Disagree RV Increase</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Part agree No RV Change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Part Agree RV Change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Part Agree RV Increase</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Part Exemption RV Change</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Partial Agree RV No Change - Change in effective date</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Trade Information Change RV</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C012</th><td class="govuk-table__cell">Trade Information No Change RV</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C013</th><td class="govuk-table__cell">Information needed</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C014</th><td class="govuk-table__cell">Case suspended</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C015</th><td class="govuk-table__cell">Case resumed</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C017</th><td class="govuk-table__cell">No change Check (change RV) decision notice</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C017</th><td class="govuk-table__cell">No Change Check (RV Change) removal</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C087</th><td class="govuk-table__cell">Agent representative for Check</td></tr>
  </tbody>
</table>


<table class="govuk-table">
  <caption class="govuk-table__caption govuk-table__caption--m">Challenge</caption>
  <thead class="govuk-table__head">
    <tr class="govuk-table__row"><th scope="col" class="govuk-table__header">Template</th> <th scope="col" class="govuk-table__header">Correspondence title</th></tr>
  </thead>
  <tbody class="govuk-table__body">
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C007</th> <td class="govuk-table__cell">Correspondence regarding your Challenge case</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C024</th> <td class="govuk-table__cell">Acknowledgement of receipt of Challenge</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C025</th> <td class="govuk-table__cell">Notice of refusal - Challenge incomplete</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C026</th> <td class="govuk-table__cell">Notice of refusal - further Challenge incomplete</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C030</th> <td class="govuk-table__cell">Challenge not accepted</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C030</th> <td class="govuk-table__cell">Covid Challenge not accepted</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C031</th> <td class="govuk-table__cell">Initial response</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C034</th> <td class="govuk-table__cell">Challenge update</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C042</th> <td class="govuk-table__cell">Request to submit new evidence accepted</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C044</th> <td class="govuk-table__cell">Information needed</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C047</th> <td class="govuk-table__cell">Challenge withdrawal confirmation</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C050</th> <td class="govuk-table__cell">Challenge accepted</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C050</th> <td class="govuk-table__cell">Challenge accepted - deletion</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C051</th> <td class="govuk-table__cell">Agreement offer addition</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C051</th> <td class="govuk-table__cell">Agreement offer</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C051</th> <td class="govuk-table__cell">Agreement offer reconstitution</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C051</th> <td class="govuk-table__cell">Agreement offer removal</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C052</th> <td class="govuk-table__cell">Decision notice</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C052</th> <td class="govuk-table__cell">Decision notice COVID MCC</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C052</th> <td class="govuk-table__cell">Decision notice COVID deletion</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C053</th> <td class="govuk-table__cell">Challenge withdrawal form (ratepayer requested)</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C053</th> <td class="govuk-table__cell">Challenge withdrawal form (VOA requested)</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C084</th> <td class="govuk-table__cell">Case closed / Late information received</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C087</th> <td class="govuk-table__cell">Agent representative for Challenge</td></tr>
  </tbody>
</table>

<table class="govuk-table">
  <caption class="govuk-table__caption govuk-table__caption--m">Property Linking</caption>
  <thead class="govuk-table__head">
    <tr class="govuk-table__row"><th scope="col" class="govuk-table__header">Template</th> <th scope="col" class="govuk-table__header">Correspondence title</th></tr>
  </thead>
  <tbody class="govuk-table__body">
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C109</th><td class="govuk-table__cell">Request to claim your property - information required</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C110</th><td class="govuk-table__cell">Request to claim your property - declined</td></tr>
  </tbody>
</table>
<table class="govuk-table">
  <caption class="govuk-table__caption govuk-table__caption--m">Valuations</caption>
  <thead class="govuk-table__head">
    <tr class="govuk-table__row"><th scope="col" class="govuk-table__header">Template</th> <th scope="col" class="govuk-table__header">Correspondence title</th></tr>
  </thead>
  <tbody class="govuk-table__body">
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C001</th><td class="govuk-table__cell">Detailed property valuation</td></tr>
  </tbody>
</table>
<table class="govuk-table">
  <caption class="govuk-table__caption govuk-table__caption--m">Agent</caption>
  <thead class="govuk-table__head">
    <tr class="govuk-table__row"><th scope="col" class="govuk-table__header">Template</th> <th scope="col" class="govuk-table__header">Correspondence title</th></tr>
  </thead>
  <tbody class="govuk-table__body">
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C301</th><td class="govuk-table__cell">Agent removed from account</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C302</th><td class="govuk-table__cell">Agent removed from properties</td></tr>
    <tr class="govuk-table__row"><th scope="row" class="govuk-table__header">C303</th><td class="govuk-table__cell">Agent removed from list year</td></tr>
  </tbody>
</table>

## Query parameters

- `ccaCaseRef` string
- `hereditamentAddress` string
- `ipOrganisationName` string
- `isRead` boolean
- `fromCreatedDateTime` string, date-time
- `toCreatedDateTime` string, date-time
- `sortField` 'CASEREF' | 'EFFECTIVE_DATE' | 'SUBJECT' | 'ADDRESS' | 'LAST_READ_AT' | 'IP_ORGANISATION_NAME'
- `page` integer
- `pageSize` integer
- `sortDirection` 'ASC' | 'DESC'

## Headers

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

## Response `200`

- GetMessageSummaryResponseSchemaJson — 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)
