# google-search-console.sitemaps.list

Sitemaps submitted for a site, with errors and warnings

> Lists the sitemaps-entries submitted for this site, or included in the sitemap index file (if `sitemapIndex` is specified in the request).

Page: https://telipot.com/catalog/tasks/google-search-console.sitemaps.list · Markdown: https://telipot.com/catalog/tasks/google-search-console.sitemaps.list/md · JSON: https://telipot.com/catalog/tasks/google-search-console.sitemaps.list/json

| Field | Value |
| --- | --- |
| provider | [Google Search Console](https://telipot.com/catalog/providers/google-search-console) `google-search-console` |
| capability | [`search-console.sitemaps.list`](https://telipot.com/catalog/capabilities/search-console.sitemaps.list) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| identity | Company account |
| auth | `oauth · OAuth 2.0 with PKCE` |
| scope | own_account |
| principal | organization |
| required_scopes | `webmasters.readonly` |
| retention | standard |
| route | `GET https://searchconsole.googleapis.com/webmasters/v3/sites/{siteUrl}/sitemaps` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://developers.google.com/webmaster-tools/v1/sitemaps/list |

## Preview the price · nothing runs

```bash
telipot run google-search-console.sitemaps.list \
  --input-json '{"siteUrl":"sc-domain:example.com"}' \
  --quote
```

## Run it

```bash
telipot run google-search-console.sitemaps.list \
  --input-json '{"siteUrl":"sc-domain:example.com"}'
```

```bash
curl https://api.telipot.com/v1/tasks/google-search-console.sitemaps.list/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"siteUrl":"sc-domain:example.com"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `siteUrl` | pathParams | string | yes |  | The property as sites.list returns it, a URL-prefix property with its trailing slash or a domain property written sc-domain:example.com |
| `sitemapIndex` | queryParams | string | no |  | A sitemap index file's URL; lists the sitemaps it includes and not those submitted for the site |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "siteUrl": {
      "type": "string",
      "description": "The property as sites.list returns it, a URL-prefix property with its trailing slash or a domain property written sc-domain:example.com",
      "examples": [
        "sc-domain:example.com"
      ]
    },
    "sitemapIndex": {
      "type": "string",
      "description": "A sitemap index file's URL; lists the sitemaps it includes and not those submitted for the site",
      "examples": [
        "https://www.example.com/sitemap_index.xml"
      ]
    }
  },
  "required": [
    "siteUrl"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "sitemap": {
      "type": "array",
      "description": "Absent when no sitemap was submitted",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "The URL of the sitemap"
          },
          "lastSubmitted": {
            "type": "string",
            "description": "RFC 3339 time"
          },
          "lastDownloaded": {
            "type": "string",
            "description": "RFC 3339 time"
          },
          "isPending": {
            "type": "boolean",
            "description": "True when Google has not processed it yet"
          },
          "isSitemapsIndex": {
            "type": "boolean",
            "description": "True when it is a collection of sitemaps"
          },
          "type": {
            "type": "string",
            "description": "The kind of sitemap such as sitemap or rssFeed"
          },
          "warnings": {
            "type": "string",
            "description": "Count as an int64 string"
          },
          "errors": {
            "type": "string",
            "description": "Count as an int64 string"
          },
          "contents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "The kind of content such as web or image"
                },
                "submitted": {
                  "type": "string",
                  "description": "URLs submitted as an int64 string"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

## Example response

From `examples/google-search-console.sitemaps.list.json`.

```json
{
  "sitemap": [
    {
      "path": "https://www.example.com/sitemap.xml",
      "lastSubmitted": "2026-09-12T08:15:30.123Z",
      "lastDownloaded": "2026-10-03T21:04:11.456Z",
      "isPending": false,
      "isSitemapsIndex": false,
      "type": "sitemap",
      "warnings": "0",
      "errors": "0",
      "contents": [
        {
          "type": "web",
          "submitted": "1842"
        }
      ]
    }
  ]
}
```