---
title: "Retrieve the status of a letter"
method: GET
path: "/letters/{id}"
tags: ["letter"]
---

# Retrieve the status of a letter

`GET /letters/{id}`

## Overview

Use this endpoint to get the current status of a single letter by its ID.

Rate limiting applies. On excess requests, you may receive **429 Too Many Requests** (example error code(s): `NOTIFY_QUOTA`). Back off and retry later.

## Sandbox test scenarios

You can test the following scenarios in our sandbox environment

| Scenario                                | Letter Id                    |
| ----------------------------------------| ---------------------------- |
| Retrieve a PENDING letter status        | `24L5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a ACCEPTED letter status       | `2AL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a PRINTED letter status        | `2BL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a ENCLOSED letter status       | `2CL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a DISPATCHED letter status     | `2DL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a DELIVERED letter status      | `2EL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a REJECTED letter status       | `2WL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a CANCELLED letter status      | `2XL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a FAILED letter status         | `2YL5eYSWGzCHlGmzNxuqVusPxDg`|
| Retrieve a RETURNED letter status       | `2ZL5eYSWGzCHlGmzNxuqVusPxDg`|

### Example Error Codes

Examples of reason codes and text that may be returned include (but are not limited to)

| Reason Code | Reason Text                |
|-------------|----------------------------|
|R01          |Addressee gone away         |
|R02          |Address incomplete          |
|R03          |Address inaccessible        |
|R04          |Addressee unknown           |
|R05          |Addressee gone away/Refused |
|R06          |Not called for              |
|R07          |No such address             |
|R08          |No reason given             |
|R09          |Deceased                    |
|R10          |Miscellaneous               |

## Response `200`

Letter status

## Other responses

- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref
- `502` — unresolved $ref

---

[API](https://skmtc.dev/nhs/apis/nhs-notify-supplier-api.md) · [All operations](https://skmtc.dev/nhs/apis/nhs-notify-supplier-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhs/nhs-notify-supplier-api/revisions/6738a29de764/schema)