Skip to documentation
Beacon Docs
TypeScript SDK

Read the calendar

Read posts in a fixed time range and show customer-safe publishing statuses.

Open Markdown

This operation requires Read schedule access. The maximum requested range is 62 days.

Request a range

const posts = await beacon.calendar.list({
  from: "2026-08-28T00:00:00.000Z",
  to: "2026-09-04T00:00:00.000Z",
});

from includes its date and time. to excludes its date and time.

Read publication statuses

for (const post of posts) {
  console.log(post.postId, post.provider, post.status);
}

The checking status means that Beacon cannot confirm the provider result yet.

A result that needs attention can appear outside the requested range. Beacon includes it so the user can take the next action.