Skip to main content
GET
/
api
/
v1
/
letters
/
{letterId}
curl https://thepostalcompany.com/api/v1/letters/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer tpc_your_api_key"
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "sent",
  "recipient": "Jane Doe",
  "address": {
    "street": "Keizersgracht",
    "number": "123",
    "suffix": "",
    "postalcode": "1015 CJ",
    "city": "Amsterdam",
    "country": "NL",
    "fullAddress": "Keizersgracht 123, 1015 CJ Amsterdam, NL"
  },
  "content": "Dear Jane,\n\nThis is a letter sent via the API.\n\nBest regards",
  "created_at": "2026-04-14T10:00:00.000Z",
  "updated_at": "2026-04-14T10:00:05.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.thepostalcompany.com/llms.txt

Use this file to discover all available pages before exploring further.

Get a Letter

Retrieve the details of a letter by its ID. You can only access letters that belong to your account.

Path parameters

letterId
string
required
The unique letter ID returned when the letter was created.

Response

id
string
The unique letter ID.
status
string
The letter status. One of: draft, processing, sent, delivered, failed.
recipient
string
The recipient name, if provided.
address
object
The structured address object.
content
string
The letter body text.
created_at
string
ISO 8601 timestamp of when the letter was created.
updated_at
string
ISO 8601 timestamp of the last update.

Examples

curl https://thepostalcompany.com/api/v1/letters/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer tpc_your_api_key"
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "sent",
  "recipient": "Jane Doe",
  "address": {
    "street": "Keizersgracht",
    "number": "123",
    "suffix": "",
    "postalcode": "1015 CJ",
    "city": "Amsterdam",
    "country": "NL",
    "fullAddress": "Keizersgracht 123, 1015 CJ Amsterdam, NL"
  },
  "content": "Dear Jane,\n\nThis is a letter sent via the API.\n\nBest regards",
  "created_at": "2026-04-14T10:00:00.000Z",
  "updated_at": "2026-04-14T10:00:05.000Z"
}

Error codes

StatusDescription
401Missing, invalid, or revoked API key
404Letter not found or does not belong to your account