GET /api/v1/templates

List templates available to the API key owner.

Query params

• scope: all (default), shared, mine
• side: front or back
• category: template category slug
• search: name search substring
• limit: 1-100 (default 20)
• cursor: template id cursor for pagination

Example

curl "https://tinypostcard.com/api/v1/templates?scope=shared&side=back&search=travel&limit=10" \
  -H "Authorization: Bearer $TINYPOSTCARD_API_KEY"

Response fields

• items[]: template metadata (id, name, category, side, location, isShared, isOwned, author)
• nextCursor: integer cursor or null

GET /api/v1/templates/{templateId}

Returns full detail and raw design JSON.

curl "https://tinypostcard.com/api/v1/templates/123" \
  -H "Authorization: Bearer $TINYPOSTCARD_API_KEY"

GET /api/v1/templates/{templateId}/html

Converts a saved template design to printable HTML.

Query params

• message (front templates): optional fallback text
• backImageUrl (back templates): optional image URL fallback

Example

curl "https://tinypostcard.com/api/v1/templates/123/html?message=Greetings+from+Denver" \
  -H "Authorization: Bearer $TINYPOSTCARD_API_KEY"

Notes

• Template access is restricted to shared templates and templates owned by the API key account.
• The response includes html plus template metadata.