# Read the calendar

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

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

## Request a range

```ts
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

```ts
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.