---
title: "List sitemap jobs"
method: GET
path: "/sitemap"
tags: ["Sitemap"]
---

# List sitemap jobs

`GET /sitemap`

## Request

- Base URL: `https://request.usestring.ai/v1`
- URL: `https://request.usestring.ai/v1/sitemap`
- Auth: HTTP bearer

List your organization's sitemap jobs, most recent first. Use it to find a jobId or review past crawls. Also served under `/map` with the same shapes.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Jobs returned.

- SitemapJobList
  - `jobs` SitemapJobSummary[], required: Most recent first.
    - `jobId` string
    - `domain` string
    - `startUrl` string
    - `status` 'awaiting_approval' | 'running' | 'completed' | 'failed' | 'canceled' | 'token_cap_exceeded': Job status.
    - `pagesProcessed` integer
    - `maxDepth` integer
    - `maxPages` integer
    - `estimatedCostUsd` string: Quoted cost in USD, as a decimal string.
    - `createdAt` string, date-time
    - `finishedAt` string, date-time, nullable
    - `errorMessage` string, nullable

## Other responses

- `401`: Missing or invalid Authorization header.
- `429`: Rate limit exceeded. The default limit is 60 requests per second per organization, averaged over a rolling window. Back off and retry with exponential backoff and jitter.

---

[API](https://skmtc.dev/usestring/apis/string-web-access-api.md) · [All operations](https://skmtc.dev/usestring/apis/string-web-access-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usestring/apis/string-web-access-api/revisions/fd336960036e?raw)