> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: listEvents(options: ListEventsOptions)

# Method package: wixBookingsV2

# Method menu location: wixBookingsV2 --> externalCalendars --> listEvents

# Method Link: https://dev.wix.com/docs/velo/apis/wix-bookings-v2/external-calendars/list-events.md

# Method Description:

Retrieves a list of events from all connected external calendars, based on the provided filtering and paging.


Use List Events to retrieve an aggregated list of events in the connected external calendars for a specified time range, sorted by start date.

> **Note:**
> Before using this function, establish a connection with an external calendar using `connectByCredentials()` or `connectByOAuth()`.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## List all events within a time range  

```javascript
import {externalCalendars} from 'wix-bookings.v2';

async function listEvents() {
    const options = {
        from: '2023-01-01T00:00:00Z',
        to: '2023-01-07T00:00:00Z'
    }
    const {events} = await externalCalendars.listEvents(options)
    return events
}
```

## List events connected to a specified schedule  

```javascript
import {externalCalendars} from 'wix-bookings.v2';

async function listScheduleEvents(from, to) {
    const options = {
        from,
        to,
        scheduleId: 'b936298d-18a6-4ae8-8e9f-10bf49314c95'
    }
    const {events: eventsOfSchedule} = await externalCalendars.listEvents(options)
    return eventsOfSchedule
}
```

## List events including personal information  

```javascript
import {externalCalendars} from 'wix-bookings.v2';

async function listEventsWithPI(from, to) {
    const options = {
        from,
        to,
        fieldsets: ['OWN_PI']
    }
    const {events: eventsWithPI} = await externalCalendars.listEvents(options)
    return eventsWithPI
}
```

---