# listCalendars (https://www.cal-sdk.com/docs/reference/list-calendars)

Most users have more than one calendar, such as work, personal and a shared team calendar. `listCalendars` returns every one they can see, so you can let them pick.

```ts
import { listCalendars } from '@cal-sdk/core';

const { calendars } = await listCalendars({ calendar });
```

## Options [#options]

Only the [common options](/docs/reference#common-options).

## Result [#result]

<TypeTable
  type={{
    calendars: { type: 'Calendar[]', description: 'Every calendar the user can see. Exactly one has `isPrimary: true`.', required: true },
    warnings: { type: 'Warning[]', required: true },
  }}
/>

See [`Calendar`](/docs/reference/types#calendar) for the fields of each calendar, and [Calendars](/docs/guides/calendars) for what `'primary'` means on each provider.

## Throws [#throws]

- `AuthenticationError` when the credentials are rejected.