Skip to main content
GET
/
newsletters
/
{newsletterId}
curl -X GET "https://api.tktchurch.com/v1/newsletters/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "January Church Updates",
  "content": "Welcome to our first newsletter of 2024...",
  "image": {
    "id": "file-123",
    "url": "https://cdn.tktchurch.com/files/newsletter-image.jpg"
  },
  "imageUrl": null,
  "pdf": {
    "id": "file-456",
    "url": "https://cdn.tktchurch.com/files/newsletter.pdf"
  },
  "pdfUrl": null,
  "hasPdf": true,
  "status": "published",
  "publishDate": "2024-01-01T12:00:00Z",
  "recipientCount": 150,
  "createdAt": "2023-12-30T15:00:00Z",
  "updatedAt": "2024-01-01T12:00:00Z",
  "createdBy": "user-123e4567-e89b-12d3-a456-426614174000"
}
This endpoint requires authentication and the readNewsletter permission.

​
Path Parameters

​
newsletterId
string
required
The UUID of the newsletter to retrieve

​
Response

​
id
string
Unique identifier for the newsletter (UUID)
​
title
string
Newsletter title
​
content
string
Newsletter content
​
image
object
Uploaded image file information
​
imageUrl
string
External image URL if not using uploaded file
​
pdf
object
Uploaded PDF file information
​
pdfUrl
string
External PDF URL if not using uploaded file
​
hasPdf
boolean
Whether the newsletter has an associated PDF
​
status
string
Newsletter status. One of: draft, scheduled, published, archived
​
publishDate
string
Scheduled or actual publication date (ISO 8601)
​
recipientCount
integer
Number of times the newsletter has been viewed/received
​
createdAt
string
Creation timestamp (ISO 8601)
​
updatedAt
string
Last update timestamp (ISO 8601)
​
createdBy
string
UUID of the user who created the newsletter

​
Error Responses

​
error
object
Error details when the request fails
Common error cases:
  • 400 Bad Request: Invalid newsletter ID format
  • 401 Unauthorized: Missing or invalid access token
  • 403 Forbidden: Missing required permission
  • 404 Not Found: Newsletter not found
curl -X GET "https://api.tktchurch.com/v1/newsletters/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "January Church Updates",
  "content": "Welcome to our first newsletter of 2024...",
  "image": {
    "id": "file-123",
    "url": "https://cdn.tktchurch.com/files/newsletter-image.jpg"
  },
  "imageUrl": null,
  "pdf": {
    "id": "file-456",
    "url": "https://cdn.tktchurch.com/files/newsletter.pdf"
  },
  "pdfUrl": null,
  "hasPdf": true,
  "status": "published",
  "publishDate": "2024-01-01T12:00:00Z",
  "recipientCount": 150,
  "createdAt": "2023-12-30T15:00:00Z",
  "updatedAt": "2024-01-01T12:00:00Z",
  "createdBy": "user-123e4567-e89b-12d3-a456-426614174000"
}