---
title: "Get a list of PENDING letters"
method: GET
path: "/letters"
tags: ["letter"]
---

# Get a list of PENDING letters

`GET /letters`

## Overview

Use this endpoint to poll letters which are ready to be printed.

Returns letters whose `status` is **PENDING**.
Use `limit` to control list size (max 2500).

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

## Query parameters

- `limit` number

## Response `200`

List of letters to process

## Other responses

- `400` — Bad request, invalid input data
- `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)