---
title: "List Ongoing And Recent Crawl Jobs Created By A User"
method: GET
path: "/v1/convai/knowledge-base/crawl"
tags: ["Conversational AI"]
---

# List Ongoing And Recent Crawl Jobs Created By A User

`GET /v1/convai/knowledge-base/crawl`

Get a list of ongoing and recent crawl jobs for the user.

## Query parameters

- `include_job_ids` string[], nullable — Ids of additional crawl jobs to retrieve
- `page_size` integer — How many documents to return at maximum. Can not exceed 100, defaults to 30.
- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- ListCrawlJobsResponseModel
  - `crawl_jobs` GetCrawlJobResponseModel[], required
    - `type` 'discovery' | 'sitemap'
    - `seed_url` string, required
    - `pattern` string, nullable
    - `max_depth` integer, required
    - `max_pages` integer, required
    - `status` 'queued' | 'processing' | 'succeeded' | 'failed' | 'skipped' | 'cancelled'
    - `pages_identified` integer
    - `pages_scraped` integer
    - `pages_skipped` integer
    - `pages_failed` integer
    - `root_folder_id` string, required
    - `updated_at` integer, required
    - `id` string, required
    - `created_at` integer, required
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/3b2cee2701a3/schema)