Announcements and Blog

These endpoints return published content and do not require authentication headers.

The poll endpoint for announcements is account-scoped and requires secret: sk1_... and x-account-access-id: aid1.....

Announcements

List published announcements

GET /api/v1/announcements

Returns a paginated list of published announcements.

Query parameters

• page - optional integer, default 1

Response fields

• items[]
• items[].id
• items[].title
• items[].summary
• items[].publishedAtUtc
• totalCount
• page
• pageSize
• hasMore

Response codes

• 200 OK

Example

curl "http://Hide-My-Email.info/api/v1/announcements?page=1"

Read one announcement

`GET /api/v1/announcements/

Returns the full content of one published announcement.

Path parameters

• id

Response fields

• id
• title
• summary
• content
• publishedAtUtc

Response codes

• 200 OK
• 404 Not Found

Example

curl "http://Hide-My-Email.info/api/v1/announcements/ann_123"

Poll for new announcements

POST /api/v1/announcements/poll

Returns announcements published after the given timestamp. Requires account authentication.

Headers

• secret: sk1_...
• x-account-access-id: aid1....

Request body fields

• sinceUtc - required ISO 8601 date-time string

Response fields

• items[]
• items[].id
• items[].title
• items[].summary
• items[].publishedAtUtc
• hasNew

Response codes

• 200 OK
• 401 Unauthorized

Example

curl -X POST "http://Hide-My-Email.info/api/v1/announcements/poll" \
  -H "secret: sk1_example" \
  -H "x-account-access-id: aid1_example" \
  -H "Content-Type: application/json" \
  -d "{\"sinceUtc\":\"2026-01-01T00:00:00Z\"}"

Blog

List published blog articles

GET /api/v1/blog

Returns a paginated list of published blog articles.

Query parameters

• page - optional integer, default 1

Response fields

• items[]
• items[].id
• items[].title
• items[].summary
• items[].publishedAtUtc
• totalCount
• page
• pageSize
• hasMore

Response codes

• 200 OK

Example

curl "http://Hide-My-Email.info/api/v1/blog?page=1"

Read one blog article

`GET /api/v1/blog/

Returns the full content of one published blog article.

Path parameters

• id

Response fields

• id
• title
• summary
• content
• publishedAtUtc

Response codes

• 200 OK
• 404 Not Found

Example

curl "http://Hide-My-Email.info/api/v1/blog/article_123"