> 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

# ListEvents

# Package: googleSearchConsole

# Namespace: GscService

# Method link: https://dev.wix.com/docs/api-reference/business-management/seo/google-search-console/site-readiness-v1/list-events.md

## Permission Scopes:
View SEO Settings: SCOPE.PROMOTE.VIEW-SEO

## Introduction

Retrieves the history of Google Search Console setup events for the site:
when it was connected, verified, added, and when sitemaps and indexing
were last submitted.

---

## REST API

### Schema

```
 Method: listEvents
 Description: Retrieves the history of Google Search Console setup events for the site: when it was connected, verified, added, and when sitemaps and indexing were last submitted.
 URL: https://www.wixapis.com/gsc/connection/v1/events
 Method: GET
 Return type: ListEventsResponse
  - name: events | type: array<Event> | description: The site's Google Search Console setup events, with the date each event last occurred.  | validation: maxItems 20
     - name: eventType | type: EventType | description: What happened.  | read-only: true 
         - enum:
         -     UNKNOWN_EVENT_TYPE: Unknown event type.
         -     ACCOUNT_CONNECTED: A Google account was connected to the site.
         -     SITE_VERIFIED: Site ownership was verified with Google.
         -     SITE_ADDED: The site was added to Google Search Console.
         -     SITEMAP_SUBMITTED: The site's sitemap was submitted to Google.
         -     SITE_INDEXING_REQUESTED: Site indexing was requested.
         -     PAGE_INDEXING_REQUESTED: Page indexing was requested.
     - name: occurredDate | type: string | description: Date and time the event last occurred.  | read-only: true | validation: format date-time


```

### Examples

### List Events
```curl
curl -X GET \
'https://www.wixapis.com/gsc/v1/events' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.gsc.siteReadiness.listEvents()
 Description: Retrieves the history of Google Search Console setup events for the site: when it was connected, verified, added, and when sitemaps and indexing were last submitted.
 Return type: PROMISE<ListEventsResponse>
  - name: events | type: array<Event> | description: The site's Google Search Console setup events, with the date each event last occurred.  | validation: maxItems 20
     - name: eventType | type: EventType | description: What happened.  | read-only: true 
         - enum:
         -     UNKNOWN_EVENT_TYPE: Unknown event type.
         -     ACCOUNT_CONNECTED: A Google account was connected to the site.
         -     SITE_VERIFIED: Site ownership was verified with Google.
         -     SITE_ADDED: The site was added to Google Search Console.
         -     SITEMAP_SUBMITTED: The site's sitemap was submitted to Google.
         -     SITE_INDEXING_REQUESTED: Site indexing was requested.
         -     PAGE_INDEXING_REQUESTED: Page indexing was requested.
     - name: occurredDate | type: Date | description: Date and time the event last occurred.  | read-only: true 


```

### Examples

### List the site's Google Search Console setup events
```javascript
import { siteReadiness } from "@wix/gsc";

async function listEvents() {
  const response = await siteReadiness.listEvents();
}

/* Promise resolves to:
 * {
 *   "events": [
 *     {
 *       "eventType": "ACCOUNT_CONNECTED",
 *       "occurredDate": "2026-08-25T14:02:10.000Z"
 *     },
 *     {
 *       "eventType": "SITE_VERIFIED",
 *       "occurredDate": "2026-08-25T14:03:41.000Z"
 *     },
 *     {
 *       "eventType": "SITE_ADDED",
 *       "occurredDate": "2026-08-25T14:03:52.000Z"
 *     },
 *     {
 *       "eventType": "SITEMAP_SUBMITTED",
 *       "occurredDate": "2026-08-25T14:04:07.000Z"
 *     }
 *   ]
 * }
 */

```

### listEvents (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { siteReadiness } from '@wix/gsc';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { siteReadiness },
  // Include the auth strategy and host as relevant
});


async function listEvents() {
  const response = await myWixClient.siteReadiness.listEvents();
};
```

---