---
title: "Your letters"
method: GET
path: "/v1/letters"
tags: ["Letters"]
---

# Your letters

`GET /v1/letters`

## Request

- Base URL: `https://app.verygoodletter.co/api`
- URL: `https://app.verygoodletter.co/api/v1/letters`
- Auth: HTTP bearer

Letters still being made, newest first. A sandbox key sees sandbox letters; a live key, the rest.

Permission: **Read only**.

## Response `200`

What it did, as JSON, with the mode it ran in.

- Answer
  - `mode` 'sandbox' | 'live', required: Which the request ran in: the key’s.

## Other responses

- `401`: No key, or one that’s been revoked.
- `429`: More than 120 requests in a minute.

---

[API](https://skmtc.dev/verygoodletter/apis/the-very-good-letter-company-api.md) · [All operations](https://skmtc.dev/verygoodletter/apis/the-very-good-letter-company-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verygoodletter/apis/the-very-good-letter-company-api/revisions/c735d65147f5?raw)