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"
}

​
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