> 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

# ListSitemaps

# Package: googleSearchConsole

# Namespace: GscService

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

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

## Introduction

Retrieves the sitemaps submitted for the site, with Google's processing
details for each: content counts, warnings, errors, and download dates.

---

## REST API

### Schema

```
 Method: listSitemaps
 Description: Retrieves the sitemaps submitted for the site, with Google's processing details for each: content counts, warnings, errors, and download dates.
 URL: https://www.wixapis.com/gsc/connection/v1/sitemaps
 Method: GET
 Return type: ListSitemapsResponse
  - name: sitemaps | type: array<Sitemap> | description: The sitemaps submitted for the site, with Google's processing details.  
     - name: url | type: string | description: URL of the sitemap.  | read-only: true | validation: format WEB_URL
     - name: type | type: string | description: Type of the sitemap. For example, `sitemap` or `rssFeed`.  | read-only: true | validation: maxLength 100
     - name: pending | type: boolean | description: Whether the sitemap hasn't been processed by Google yet.  | read-only: true 
     - name: sitemapsIndex | type: boolean | description: Whether the sitemap is an index of other sitemaps.  | read-only: true 
     - name: lastDownloadedDate | type: string | description: Date and time Google last downloaded the sitemap.  | read-only: true | validation: format date-time
     - name: lastSubmittedDate | type: string | description: Date and time the sitemap was last submitted.  | read-only: true | validation: format date-time
     - name: errorCount | type: string | description: Number of issues with the sitemap itself. Errors must be fixed before Google can process the sitemap correctly.  | read-only: true 
     - name: warningCount | type: string | description: Number of non-critical issues with URLs in the sitemap.  | read-only: true 
     - name: contents | type: array<SitemapContent> | description: Breakdown of the sitemap's contents by content type.  | read-only: true | validation: maxItems 100
        - name: type | type: string | description: Content type. For example, `web` or `image`.  | read-only: true | validation: maxLength 100
        - name: submittedCount | type: string | description: Number of URLs of this content type in the sitemap.  | read-only: true 
        - name: indexedCount | type: string | description: Number of URLs of this content type that Google has indexed.  | read-only: true 

 Possible Errors:
   HTTP Code: 428 | Status Code: FAILED_PRECONDITION | Application Code: MISSING_TOKEN | Description: No Google account is connected for this site. Connect first with the GSC Connection API.
   HTTP Code: 429 | Status Code: RESOURCE_EXHAUSTED | Application Code: GOOGLE_QUOTA_EXCEEDED | Description: Google's API quota for the property is used up. Retry after the quota window resets.
   HTTP Code: 503 | Status Code: UNAVAILABLE | Application Code: GOOGLE_UNAVAILABLE | Description: Google answered with a temporary server error. Retry with backoff.


```

### Examples

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

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.gsc.siteReadiness.listSitemaps()
 Description: Retrieves the sitemaps submitted for the site, with Google's processing details for each: content counts, warnings, errors, and download dates.
 Return type: PROMISE<ListSitemapsResponse>
  - name: sitemaps | type: array<Sitemap> | description: The sitemaps submitted for the site, with Google's processing details.  
     - name: url | type: string | description: URL of the sitemap.  | read-only: true | validation: format WEB_URL
     - name: type | type: string | description: Type of the sitemap. For example, `sitemap` or `rssFeed`.  | read-only: true | validation: maxLength 100
     - name: pending | type: boolean | description: Whether the sitemap hasn't been processed by Google yet.  | read-only: true 
     - name: sitemapsIndex | type: boolean | description: Whether the sitemap is an index of other sitemaps.  | read-only: true 
     - name: lastDownloadedDate | type: Date | description: Date and time Google last downloaded the sitemap.  | read-only: true 
     - name: lastSubmittedDate | type: Date | description: Date and time the sitemap was last submitted.  | read-only: true 
     - name: errorCount | type: string | description: Number of issues with the sitemap itself. Errors must be fixed before Google can process the sitemap correctly.  | read-only: true 
     - name: warningCount | type: string | description: Number of non-critical issues with URLs in the sitemap.  | read-only: true 
     - name: contents | type: array<SitemapContent> | description: Breakdown of the sitemap's contents by content type.  | read-only: true | validation: maxItems 100
        - name: type | type: string | description: Content type. For example, `web` or `image`.  | read-only: true | validation: maxLength 100
        - name: submittedCount | type: string | description: Number of URLs of this content type in the sitemap.  | read-only: true 
        - name: indexedCount | type: string | description: Number of URLs of this content type that Google has indexed.  | read-only: true 

 Possible Errors:
   HTTP Code: 428 | Status Code: FAILED_PRECONDITION | Application Code: MISSING_TOKEN | Description: No Google account is connected for this site. Connect first with the GSC Connection API.
   HTTP Code: 429 | Status Code: RESOURCE_EXHAUSTED | Application Code: GOOGLE_QUOTA_EXCEEDED | Description: Google's API quota for the property is used up. Retry after the quota window resets.
   HTTP Code: 503 | Status Code: UNAVAILABLE | Application Code: GOOGLE_UNAVAILABLE | Description: Google answered with a temporary server error. Retry with backoff.


```

### Examples

### List the site's sitemaps with Google's processing details
```javascript
import { siteReadiness } from "@wix/gsc";

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

/* Promise resolves to:
 * {
 *   "sitemaps": [
 *     {
 *       "url": "https://www.my-fashion-store.com/sitemap.xml",
 *       "type": "sitemap",
 *       "pending": false,
 *       "sitemapsIndex": true,
 *       "lastDownloadedDate": "2026-08-30T06:12:44.000Z",
 *       "lastSubmittedDate": "2026-08-28T09:03:17.000Z",
 *       "errorCount": 0,
 *       "warningCount": 2,
 *       "contents": [
 *         {
 *           "type": "web",
 *           "submittedCount": 24,
 *           "indexedCount": 18
 *         },
 *         {
 *           "type": "image",
 *           "submittedCount": 63,
 *           "indexedCount": 41
 *         }
 *       ]
 *     }
 *   ]
 * }
 */

```

### listSitemaps (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 listSitemaps() {
  const response = await myWixClient.siteReadiness.listSitemaps();
};
```

---